[ARROW-13336] [Doc][Python] make clean doesn't clean up "generated" documentation

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 4.0.1
• Fix Version/s: 6.0.0
• Component/s: Documentation
• Labels: pull-request-available
• External issue URL: https://github.com/apache/arrow/issues/29011
• Assignee: Alessandro Molina
• Reporter: Alessandro Molina
• Created: 14/Jul/21 11:42
• Updated: 11/Jan/23 08:32
• Resolved: 26/Jul/21 13:18

Description

Running `make clean` in the docs directory doesn't get rid of the content generated in the `generated` directory. That means that if any file was removed (and thus won't be generated anymore) it would still end up being included in the documentation because "not generating it" doesn't mean "deleting the already generated one".

Best case that can lead to errors when generating the docs, worst case it might generate wrong doc that contains sections that are no longer valid.

Issue Links

• is a child of: ARROW-13407 [Documentation] Documentation Improvements
• links to: GitHub Pull Request #10755