zookeeper-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Norbert Kalmar <nkal...@cloudera.com.INVALID>
Subject Re: DISCUSSION: Drop PDF support in documentation
Date Fri, 05 Oct 2018 08:30:32 GMT
Sounds logical to me, dropping pdf support / generation.
+1

On Thu, Oct 4, 2018 at 10:47 PM Michael Han <hanm@apache.org> wrote:

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