[ARROW-4332] [Website] Instructions and scripts for publishing web site appear to be incorrect

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 0.13.0
• Component/s: Website
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/20901
• Assignee: Andy Grove
• Reporter: Andy Grove
• Created: 23/Jan/19 03:33
• Updated: 11/Jan/23 07:33
• Resolved: 27/Jan/19 17:00

Description

I tried following the instructions for publishing the web site and failed. Issues:

1. The instructions say to clone the asf-site repo but doesn't say where to clone it to (under arrow repo root dir? under arrow/site dir? somewhere else?)

2. The instructions don't say which directory to run the bundle command from. It's probably obvious to some people but not me. I'm assuming it should be from arrow/site

3. The script "script/sync_format_docs.sh" seems to be looking in the wrong path and fails.

4. After manually copying the format docs, jekyll fails to serve the content because there is no IPC.md (there are others, just not IPC) .. looks like IPC is a .rst file not an MD?

I'll try and figure this out myself and create a PR to fix ....

 

 

 

 

Issue Links

• links to: GitHub Pull Request #3498