[
https://issues.apache.org/jira/browse/ARROW-95?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15226560#comment-15226560
]
Wes McKinney commented on ARROW-95:
-----------------------------------
See an example of a Sphinx-generated PDF:
http://pandas.pydata.org/pandas-docs/version/0.18.0/pandas.pdf. Setting aside
the fact that the release notes is 250 pages, in my experience people do like
having PDF versions of things.
> Scaffold Main Documentation using asciidoc
> ------------------------------------------
>
> Key: ARROW-95
> URL: https://issues.apache.org/jira/browse/ARROW-95
> Project: Apache Arrow
> Issue Type: Task
> Reporter: Uwe L. Korn
>
> For the general documentation of Arrow, we want to use asciidoc. The "general
> documentation" includes:
> * The Arrow spec / memory layout
> * Howtos for building arrow on different platforms
> * Getting Started snippets for each language and a link to the (to-be-build)
> API documentation
> It would be nice to have a build system and the main file/folder structure in
> place so we can split the work up.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
