[ARROW-4427] [Doc] Move Confluence Wiki pages to the Sphinx docs

• Type: Task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 1.0.0
• Component/s: Documentation
• External issue URL: https://github.com/apache/arrow/issues/20988
• Assignee: Neal Richardson
• Reporter: Tanya Schlusser
• Created: 30/Jan/19 14:30
• Updated: 11/Jan/23 07:33
• Resolved: 11/Jun/20 18:43

Description

It's hard to find and modify the "Contributing to Apache Arrow" and other developers' wiki pages in Confluence. If these were moved to inside the project web page, that would make it easier.

There are 5 steps to this:

1. Create a new directory inside of `arrow/docs/source` to house the wiki pages. (It will look like the cpp or python directories.)
2. Copy the wiki page contents to new `*.rst` pages inside this new directory.
3. Add an `index.rst` that links to them all with enough description to help navigation.
4. Modify the Sphinx index page `arrow/docs/source/index.rst` to have an entry that points to the new index page made in step 3
5. Modify the static site page `arrow/site/_includes/header.html` to point to the newly created page instead of the wiki page.

 

Issue Links

• blocks: ARROW-3364 [Doc] Document docker compose setup
• blocks: ARROW-4425 Add link to 'Contributing' page in the top-level Arrow README
• blocks: ARROW-4429 [Doc] Add git rebase tips to the 'Contributing' page in the developer docs