[jira] [Commented] (COUCHDB-3329) Remove PDF and texinfo targets from default doc build

["ASF GitHub Bot (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/COUCHDB-3329?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15931596#comment-15931596 ] 

ASF GitHub Bot commented on COUCHDB-3329:
-----------------------------------------

GitHub user wohali opened a pull request:

    https://github.com/apache/couchdb-documentation/pull/116

    Remove pdf and info builds from default target

    As discussed on the mailing list, this removes the PDF and info
    builds from the default build.
    
    Fixes COUCHDB-3329
    
    Relates to apache/couchdb:3329-kill-pdf-texinfo branch.

You can merge this pull request into a Git repository by running:

    $ git pull https://github.com/apache/couchdb-documentation 3329-kill-pdf-texinfo

Alternatively you can review and apply these changes as the patch at:

    https://github.com/apache/couchdb-documentation/pull/116.patch

To close this pull request, make a commit to your master/trunk branch
with (at least) the following in the commit message:

    This closes #116
    
----
commit 2474c99cd23aab89823df8901afb1a690b63fb1d
Author: Joan Touzet <wo...@apache.org>
Date:   2017-03-19T06:37:18Z

    Remove pdf and info builds from default target

----


> Remove PDF and texinfo targets from default doc build
> -----------------------------------------------------
>
>                 Key: COUCHDB-3329
>                 URL: https://issues.apache.org/jira/browse/COUCHDB-3329
>             Project: CouchDB
>          Issue Type: Wish
>          Components: Documentation
>            Reporter: Joan Touzet
>
> 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 never seen anyone use or talk about the texinfo target.
> 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.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)