couchdb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Davis <paul.joseph.da...@gmail.com>
Subject Re: [PROPOSAL] Drop PDF / texinfo documentation builds
Date Sat, 18 Mar 2017 16:55:29 GMT
+1

On Sat, Mar 18, 2017 at 8:15 AM Nick Vatamaniuc <vatamane@gmail.com> wrote:

> +1
>
> On Mar 18, 2017 12:56 AM, "Joan Touzet" <wohali@apache.org> 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
> >
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message