Re: All-in-one site documentation

2023-12-18 Thread Volkan Yazıcı
Thanks for the heads up Gary. I was (and still am!) a big fan of utilizing
Javadoc for the manual. This is pretty relevant for the website revamp
email I just shared. I will explore the Juneau approach in detail and share
my findings in the tooling-related thread I intend to send sometime this
week.

On Mon, Dec 18, 2023 at 6:37 PM Gary D. Gregory  wrote:

> Hi All,
>
> A while back, I mentioned that we could (not should) have our
> documentation generated within Javadoc. Here is an example from another
> Apache project I participate in:
>
> https://juneau.apache.org/site/apidocs-9.0.1/index.html
>
> I'm late to Juneau and I don't know the ins and out of how it's made, but
> it looks good nonetheless IMO.
>
> Gary
>


Re: All-in-one site documentation

2023-12-18 Thread Matt Sicker
This is pretty cool!

> On Dec 18, 2023, at 11:37 AM, Gary D. Gregory  wrote:
> 
> Hi All,
> 
> A while back, I mentioned that we could (not should) have our documentation 
> generated within Javadoc. Here is an example from another Apache project I 
> participate in: 
> 
> https://juneau.apache.org/site/apidocs-9.0.1/index.html
> 
> I'm late to Juneau and I don't know the ins and out of how it's made, but it 
> looks good nonetheless IMO.
> 
> Gary



Re: All-in-one site documentation

2023-12-18 Thread Gary D. Gregory
FYI 
https://cwiki.apache.org/confluence/display/JUNEAU/Adding+content+to+the+overview-summary.html+file

On 2023/12/18 17:37:36 "Gary D. Gregory" wrote:
> Hi All,
> 
> A while back, I mentioned that we could (not should) have our documentation 
> generated within Javadoc. Here is an example from another Apache project I 
> participate in: 
> 
> https://juneau.apache.org/site/apidocs-9.0.1/index.html
> 
> I'm late to Juneau and I don't know the ins and out of how it's made, but it 
> looks good nonetheless IMO.
> 
> Gary
> 


All-in-one site documentation

2023-12-18 Thread Gary D. Gregory
Hi All,

A while back, I mentioned that we could (not should) have our documentation 
generated within Javadoc. Here is an example from another Apache project I 
participate in: 

https://juneau.apache.org/site/apidocs-9.0.1/index.html

I'm late to Juneau and I don't know the ins and out of how it's made, but it 
looks good nonetheless IMO.

Gary