+1 On Mar 18, 2017 12:56 AM, "Joan Touzet" <[email protected]> wrote:
> Hi everyone, > > I'd like to propose dropping the PDF and texinfo targets from our > documentation build, or at the very least, having them not be part of > the default target / not standard deliverables for the project. > > We'd continue to build HTML documentation as part of the workflow, > naturally, as well as the man pages. > > I don't have any solid numbers, but I'm fairly sure most people use > https://docs.couchdb.org/ or a locally installed copy for their > documentation for CouchDB rather than the PDF documentation. I > personally can't remember the last time I opened the docs in PDF form. I > also have never seen anyone refer to the PDF docs on the mailing lists, > IRC or Slack when asking for advice or support. > > I've also never seen anyone use or talk about the texinfo target, and > I've not used them myself. > > Dropping this dependency will allow us to drop TeX/LaTeX from our build > chain, which speeds up build times by about 90 seconds and reduces the > size of containers currently being built for our Jenkins CI workflow. > It also means CouchDB devs don't have to install 0.5-1.5GB worth of > toolset. > > I've captured this in JIRA as > https://issues.apache.org/jira/browse/COUCHDB-3329 and have PRs ready > to fire off if people agree. > > Your thoughts? > > -Joan >
