Re: Putting subproject docs in the code repos -- sample preview available

2021-07-30 Thread Carsten Ziegeler
Hi David, the directory path is not nice and deep, but I don't mind that much. I didn't want to rehash a discussion about markdown vs asciidoc in general - asciidoc for our website is totally fine. There is not much happening on that front anyway. As I said if everyone is fine with convertin

Re: Putting subproject docs in the code repos -- sample preview available

2021-07-29 Thread David Jencks
inline... > On Jul 29, 2021, at 9:28 PM, Carsten Ziegeler wrote: > > I like the approach in general, the location of the adoc file within the scr > tree is a little bit awkward, but not a showstopper. To me Antora directory structure is a bit like maven project layout, once you get used to it

Re: Putting subproject docs in the code repos -- sample preview available

2021-07-29 Thread Carsten Ziegeler
I like the approach in general, the location of the adoc file within the scr tree is a little bit awkward, but not a showstopper. What I personally don't like is that these files need to be written in asciidoc and not gh markdown. But if everyone else is fine with that, I can probably adjust.

Re: Putting subproject docs in the code repos -- sample preview available

2021-07-28 Thread David Jencks
I’ve set up a somewhat usable preview workflow and a preview for scr for what I’d like for the subproject docs. Take a look at https://felix.staged.apache.org/. Scr is now in the nav under subprojects and linked from the table of subprojects. The minimal README.adoc is visible at https://gith