[jira] [Commented] (ARROW-95) Scaffold Main Documentation using asciidoc

["Jacques Nadeau (JIRA)" <ji...@apache.org>]

    [ 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)