You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@arrow.apache.org by "Antoine Pitrou (JIRA)" <ji...@apache.org> on 2019/01/30 14:33:00 UTC
[jira] [Commented] (ARROW-4427) Move "Contributing to Apache Arrow"
page to the static docs
[ 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)