I've fixed this. Let me know if there is anything else I missed, please. -Flavio
> On 10 Aug 2016, at 15:24, Flavio Junqueira <[email protected]> wrote: > > I thought we were generating the new documentation upon releasing. I just > checked the how to release and we are just copying. I'll take care of it. > > -Flavio > >> On 10 Aug 2016, at 07:52, Mohammad arshad <[email protected]> wrote: >> >> 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 >>> >>> >
