Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
MIME-Version: 1.0
References: <747629.704.1489811427469.JavaMail.Joan@RITA> <3545194.713.1489812943690.JavaMail.Joan@RITA>
 <CAJd=5HYScwzwehqbaw2nSJt5oi1V666eyZhPmoqDB70sqRnupQ@mail.gmail.com>
In-Reply-To: <CAJd=5HYScwzwehqbaw2nSJt5oi1V666eyZhPmoqDB70sqRnupQ@mail.gmail.com>
From: Paul Davis <paul.joseph.davis@gmail.com>
Date: Sat, 18 Mar 2017 16:55:29 +0000
Message-ID: <CAJ_m3YCaG7h-MVAT4uPxKo34bFnV-u5m7dS-gCXsSfeucktV4Q@mail.gmail.com>
Subject: Re: [PROPOSAL] Drop PDF / texinfo documentation builds
To: dev@couchdb.apache.org
Content-Type: multipart/alternative; boundary=94eb2c1b464efd4b90054b0429e4
archived-at: Sat, 18 Mar 2017 17:02:43 -0000

--94eb2c1b464efd4b90054b0429e4
Content-Type: text/plain; charset=UTF-8

+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
> >
>

--94eb2c1b464efd4b90054b0429e4--