Uploaded image for project: 'Teiid'
  1. Teiid
  2. TEIID-4500

Make documents to capable of building outside the GitBooks

XMLWordPrintable

    • Icon: Task Task
    • Resolution: Obsolete
    • Icon: Major Major
    • None
    • None
    • Documentation
    • None

      Currently Teiid documentation is only built by automated process by GitBooks. However, this causes couple issues

      • There is no way to check the documentation formatting external to the GitBook.
      • Documents need to be always hosted by the Gitbook. I am sure there is way to export, but that may need human to do that? Going forward we would need a automated way if one wants to bundle the documents.
      • Gitbook only allows two books for free, we already against this limit with no resolution with the paid route.

      Thus it may be better we also have alternative ways to generate final documents, and be able to host on teiid.org. I find an example with Infinispan documents, we just need to mimic what they are doing

      >> We have also implemented generation of PDFs via the
      > > asciidoctor-maven-plugin with optimized post-processing via GhostScript
      > > (which shrinks the size of the PDFs to a 1/4 of the size).
      > > Look at [2] and [3] to see how that is done.
      > >
      > > Tristan
      > >
      > > [1] http://infinispan.org/docs/dev/user_guide/user_guide.html
      > > [2]
      > > https://github.com/infinispan/infinispan/blob/master/documentation/pom.xml
      > > [3]
      > > https://github.com/infinispan/infinispan/blob/master/documentation/optimize-pdf.xml

      also look at their google-analytics stuff, that is very useful to have. I do also like Infinispans style sheets better than the current default GitBook's, we should adapt them too.

            rhn-engineering-rareddy Ramesh Reddy
            rhn-engineering-rareddy Ramesh Reddy
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: