1. I think it is ok to update the document, in the release tar, in the next release 2. Can we generate and update the documentation site http://zookeeper.apache.org/doc/r3.5.2-alpha/, because mostly people refer this website for document reference.
-Arshad -----Original Message----- From: Patrick Hunt [mailto:[email protected]] Sent: 10 August 2016 00:06 To: DevZooKeeper; Flavio Subject: Re: http://zookeeper.apache.org/doc/r3.5.2-alpha/ showing old document Thanks for catching this Mohammad, it looks like this commit changed the source on 3.5 branch but the generated docs were not re-generated: + ZOOKEEPER-2402: Document client side properties (Arshad Mohammad via + fpj) svn commit: r1745280 - in /zookeeper/branches/branch-3.5: CHANGES.txt src/docs/src/documentation/content/xdocs/zookeeperAdmin.xml src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml As a result the published documentation is out of date with the source. We have a few options, including but not limited to: 1) fix it during the next release (i.e. ignore it for now), 2) someone could regenerate the documentation for that release and update the published docs manually. others? Patrick On Mon, Aug 8, 2016 at 8:24 AM, Mohammad arshad <[email protected]> wrote: > http://zookeeper.apache.org/doc/r3.5.2-alpha/ is not showing the > documentation which is released with zookeeper-3.5.2-alpha Released > tar ball has up to date documentation source but the generated > document is still old. > > For example: > src\docs\src\documentation\content\xdocs\zookeeperProgrammers.xml has > bellow content <varlistentry> > <term>zookeeper.sasl.client</term> > <listitem> > <para>Set the value to <emphasis > role="bold">false</emphasis> to disable > SASL authentication. Default is > <emphasis role="bold">true</emphasis>.</para> > </listitem> > </varlistentry> > But generated document file docs/zookeeperProgrammers.html does not > have above content. > > -Arshad > >
