[ARROW-13379] [Dev][Docs] Improvements to archery docs

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 6.0.0
• Component/s: Developer Tools, Documentation
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/29052
• Assignee: Unassigned
• Reporter: Neal Richardson
• Created: 19/Jul/21 13:10
• Updated: 11/Jan/23 08:32
• Resolved: 02/Aug/21 14:40

Description

A running list as I try to figure out how to run archery locally:

• dev/archery needs a README.md (even if it just links to docs/source/developers/archery.rst and docs/source/developers/crossbow.rst)
• The archery --help example output on the docs is outdated
• archery crossbow --help shows nothing of use
• To install crossbow, pip install -e "dev/archery[crossbow]" (note: the quotes are required on zsh shells)
• Do I *really* need to create the queue? IME I don't I can use ursacomputing/crossbow and it just works — that's probably because I have been granted permissions there. If that's the case we should explain that ("if you have permissions at ursacopmuting/crossbow you don't need to ... just clone the ursacopmuting/crossbow repo and... but if you do not have permissions, then you should ....")

Issue Links

• links to: GitHub Pull Request #10830