zookeeper-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael Han <h...@apache.org>
Subject Re: DISCUSSION: Drop PDF support in documentation
Date Thu, 04 Oct 2018 22:47:20 GMT
+1 on dropping support for PDF documents. Most if not all of the other
apache projects only provide html documents.

On Wed, Oct 3, 2018 at 1:18 AM Enrico Olivelli <eolivelli@gmail.com> wrote:

> Il giorno mer 3 ott 2018 alle ore 09:34 Tamas Penzes
> <tamaas@cloudera.com.invalid> ha scritto:
> >
> > Hi All,
> >
> > As part of "ZOOKEEPER-925 Consider maven site generation to replace our
> > forrest site and documentation generation" I have implemented
> > "ZOOKEEPER-3153 Create MarkDown files and build process for them".
> >
> > The solution would replace the old Forrest based document creation with
> > MarkDown based one, which is easier to create, edit, maintain, etc.
> > I also had the goal that the new solution should work out of the box,
> > without the need to install anything on the build machine. You just check
> > out the project and are already able to build and generate the project,
> > including the documentation.
> >
> > From the .md files I still create HTML content for the webpage (just try
> > out `mvn clean install` and check zookeeper-docs/target/html/) but I
> > haven't found a proper way to create PDFs directly from the .md files.
> >
> > As far as I know PDFs are not really used, so it would be enough to add
> the
> > .md and .html content to the tarball and we could skip the PDF
> generation.
> >
> > What do you think about it?
> > Is there anyone who would need PDFs?
>
> I (and my company) don't need them.
> IMHO you don't need a PDF version of ZK docs
>
> so +1 for dropping
>
> Enrico
>
>
> >
> > Thanks, Tamaas
>

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