You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-dev@db.apache.org by "Nileflowers (MI) (JIRA)" <de...@db.apache.org> on 2005/05/24 16:52:03 UTC

[jira] Created: (DERBY-312) PDF Docs

PDF Docs
--------

         Key: DERBY-312
         URL: http://issues.apache.org/jira/browse/DERBY-312
     Project: Derby
        Type: Wish
  Components: Documentation  
 Environment: ALL
    Reporter: Nileflowers (MI)


Why is it so hard to build documentation PDFs from DITA sources and post them to the site? Why do we have to build it ourselves individually?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (DERBY-312) PDF Docs

Posted by "Nileflowers (MI) (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-312?page=comments#action_66173 ]
     
Nileflowers (MI) commented on DERBY-312:
----------------------------------------

Don't mind, found PDFs

> PDF Docs
> --------
>
>          Key: DERBY-312
>          URL: http://issues.apache.org/jira/browse/DERBY-312
>      Project: Derby
>         Type: Wish
>   Components: Documentation
>  Environment: ALL
>     Reporter: Nileflowers (MI)

>
> Why is it so hard to build documentation PDFs from DITA sources and post them to the site? Why do we have to build it ourselves individually?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (DERBY-312) PDF Docs

Posted by "scott hutinger (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-312?page=comments#action_66175 ]
     
scott hutinger commented on DERBY-312:
--------------------------------------

Could you be a bit more specific on this issue?  

Nobody has to build the docs, as builds are on the website in both html/html-single/pdf formats that are built nightly.  It's really not all that hard to build, you download the dita sources, download the DITA-OT, and build.  But nobody has to build it themselves.  Just goto the website, and download the dita output in one of those three formats.

The nice thing is, if someone wants another format to output, then download the sources and add the output wanted.

Docs are always a pain, and I see the current solution a heck of a lot nicer than anything else I have seen :-)


> PDF Docs
> --------
>
>          Key: DERBY-312
>          URL: http://issues.apache.org/jira/browse/DERBY-312
>      Project: Derby
>         Type: Wish
>   Components: Documentation
>  Environment: ALL
>     Reporter: Nileflowers (MI)

>
> Why is it so hard to build documentation PDFs from DITA sources and post them to the site? Why do we have to build it ourselves individually?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Commented: (DERBY-312) PDF Docs

Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-312?page=comments#action_66180 ]
     
Jean T. Anderson commented on DERBY-312:
----------------------------------------

Added an FAQ to clarify where to find the prebuilt Derby documentation, committed revision 178201. It'll be visible at http://incubator.apache.org/derby/faq.html#where_are_docs with the next www.apache.org web site sync.

> PDF Docs
> --------
>
>          Key: DERBY-312
>          URL: http://issues.apache.org/jira/browse/DERBY-312
>      Project: Derby
>         Type: Wish
>   Components: Documentation
>  Environment: ALL
>     Reporter: Nileflowers (MI)

>
> Why is it so hard to build documentation PDFs from DITA sources and post them to the site? Why do we have to build it ourselves individually?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Closed: (DERBY-312) PDF Docs

Posted by "Jean T. Anderson (JIRA)" <de...@db.apache.org>.
     [ http://issues.apache.org/jira/browse/DERBY-312?page=all ]
     
Jean T. Anderson closed DERBY-312:
----------------------------------

    Resolution: Fixed

The problem wasn't the documentation itself, but confusion about where to find the built documentation. Verified that the new FAQ that clarifies this made is live at http://incubator.apache.org/derby/faq.html#where_are_docs .

> PDF Docs
> --------
>
>          Key: DERBY-312
>          URL: http://issues.apache.org/jira/browse/DERBY-312
>      Project: Derby
>         Type: Wish
>   Components: Documentation
>  Environment: ALL
>     Reporter: Nileflowers (MI)

>
> Why is it so hard to build documentation PDFs from DITA sources and post them to the site? Why do we have to build it ourselves individually?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira