That makes sense St.Ack and probably do what Jon suggested about keeping the docs build outside of the source tarball.
thanks, esteban. -- Cloudera, Inc. On Wed, Aug 6, 2014 at 11:14 AM, Stack <[email protected]> wrote: > On Wed, Aug 6, 2014 at 10:51 AM, Jonathan Hsieh <[email protected]> wrote: > > > Hm.. so previously we release the trunk docs with the 0.98 releases? > this > > seems strange. I would think 0.98 docs would be generated from the 0.98 > > release branch's branch. > > > > > We have not done the work to keep up version-specific documentation. The > differences have been too minor to matter and if version specific doc at > all, an effort has been made to call it out explicitly with 'since > hbase-X.X.X'. > > 0.94 though has its own API and doc generated from a (old now) build off > 0.94 branch. > > > > > It seems reasonable if in our post-git releases we have the source for > the > > docs in the source tarballs but not the build docs. The built docs > > however, are in the ready-to-use release tarballs and correspond to the > > release. Is this the case now? > > > > Doing this becomes more important because the docs will likely change due > > to deployment changes with potentially different rules of thumb etc for > > 0.98->1.0 vs what will be 2.0 releases. > > > > > Agree. When 2.0 doc starts to diverge from 1.0 doc in a significant way, > lets move to keep up two different docs -- a branch-1 and a branch-2. > > I don't see a need for our doing that yet. > > St.Ack >
