Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
From: Jan Lehnardt <mail@jan.io>
Content-Type: text/plain;
	charset=us-ascii
Content-Transfer-Encoding: 7bit
Mime-Version: 1.0 (1.0)
Date: Sat, 18 Mar 2017 08:14:50 +0100
Subject: Re: [PROPOSAL] Drop PDF / texinfo documentation builds
Message-Id: <D91A8F2B-94EA-4E74-A47C-E5FC95039806@jan.io>
References: <3545194.713.1489812943690.JavaMail.Joan@RITA>
In-Reply-To: <3545194.713.1489812943690.JavaMail.Joan@RITA>
To: dev@couchdb.apache.org
archived-at: Sat, 18 Mar 2017 07:15:11 -0000

+1

Cheers
Jan
--

> On 18 Mar 2017, at 05:55, 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