At https://cwiki.apache.org/confluence/display/OFBIZ/Draft+Documentation+Roadmap

Sharan already suggested to "Backport to releases where possible"

I think we should do that and not way R18 to use the AsciiDoc generation even 
if it's not complete

Opinions before I get ahead?

Jacques


Le 14/11/2018 à 08:41, Jacques Le Roux a écrit :
Hi,

So start this discussion, currently our main documents in docs\asciidoc refer 
to the R17 release. But those document don't exist in R17 branch.

I think it's not too late to backport them, but do we want to do so?

Also I suggested to have an easy access to the documentation from the site 
documentation page.

Do we also want to use the AsciiDoc generated documentation as we did to 
provide an online help from the applications?

Do we want to provide something like 
https://demo-trunk.ofbiz.apache.org/cmssite/cms/APACHE_OFBIZ_HTML?

For me the answers to these questions is NO! We should have a sole entry point for the documentation and it should be from the site documentation page. It's then easy to provide links from there (using anchors going to automatically generated IDs sections)

What are your opinions? (I know I should re-read this thread 
https://markmail.org/message/35ak34fpzlyjiopt and I started...)

Jacques



Reply via email to