[
https://issues.apache.org/jira/browse/ARROW-95?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15226473#comment-15226473
]
Jacques Nadeau commented on ARROW-95:
-------------------------------------
I didn't see a conversation about why asciidoc versus Markdown. Did I miss the
discussion? We've been using Markdown on Drill and Calcite with reasonable
success.
> 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)
