Hi Jacques, I support the suggestion made by Sharan. It should not be too difficult, when a release has been made available (this should be part of the release activities), to generate the 'release' related documents and hook it into the website. Our (potential) adopters will benefit.
Best regards, Pierre Smits *Apache Trafodion <https://trafodion.apache.org>, Vice President* *Apache Directory <https://directory.apache.org>, PMC Member* Apache Incubator <https://incubator.apache.org>, committer *Apache OFBiz <https://ofbiz.apache.org>, contributor (without privileges) since 2008* Apache Steve <https://steve.apache.org>, committer On Thu, Nov 15, 2018 at 12:59 PM Jacques Le Roux < jacques.le.r...@les7arts.com> wrote: > 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 > > > > > >
