[
https://issues.apache.org/jira/browse/ARROW-4427?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16756166#comment-16756166
]
Antoine Pitrou commented on ARROW-4427:
---------------------------------------
I think this would be better moved to the Sphinx docs, which allow extensive
cross-referencing. IMHO the Jekyll site should only be used for top-level pages
and the blog.
See https://github.com/apache/arrow/tree/master/docs
> Move "Contributing to Apache Arrow" page to the static docs
> -----------------------------------------------------------
>
> Key: ARROW-4427
> URL: https://issues.apache.org/jira/browse/ARROW-4427
> Project: Apache Arrow
> Issue Type: Task
> Components: Documentation
> Reporter: Tanya Schlusser
> Priority: Major
>
> It's hard to find and modify the ["Contributing to Apache
> Arrow"|https://cwiki.apache.org/confluence/display/ARROW/Contributing+to+Apache+Arrow]
> wiki page in Confluence. If it were moved to inside the static web page,
> that would make it easier.
> There are two steps to this:
> # Copy the wiki page contents to a new web page at the top "site" level
> (under arrow/site/ just like the [committers
> page|https://github.com/apache/arrow/blob/master/site/committers.html]) Maybe
> named "contributing.html" or something.
> # Modify the [navigation section in
> arrow/site/_includes/header.html|https://github.com/apache/arrow/blob/8e195327149b670de2cd7a8cfe75bbd6f71c6b49/site/_includes/header.html#L33]
> to point to the newly created page instead of the wiki page.
> The affected pages are all part of the Jekyll components, so there isn't a
> need to build the Sphinx part of the docs to check your work.
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
