[CASSANDRA-18718] Fix gen-doc task

• Type: Bug
• Status: Resolved
• Priority: Normal
• Resolution: Fixed
• Fix Version/s: 5.0-alpha1, 5.0
• Component/s: Documentation
• Bug Category: Correctness
• Severity: Low
• Complexity: Normal
• Discovered By: User Report
• Platform: All
• Since Version: 5.0-alpha1

Source Control Link

https://github.com/apache/cassandra/commit/1e2c88f

Test and Documentation Plan

n/a

• Assignee: Lorina Poland
• Reporter: Ekaterina Dimitrova

Authors

Lorina Poland

Reviewers

Michael Semb Wever

• Created: 01/Aug/23 17:20
• Updated: 02/Jan/24 20:10
• Resolved: 02/Jan/24 20:10

Description

As discussed on CASSANDRA-17687, we see below errors when ant gen-doc is run:

gen-asciidoc: [exec] python3 ./scripts/gen-nodetool-docs.py [exec] python3 ./scripts/convert_yaml_to_adoc.py ../conf/cassandra.yaml ./modules/cassandra/pages/configuration/cass_yaml_file.adoc [exec] Traceback (most recent call last): [exec] File "/home/jlewandowski/dev/cassandra/trunk/doc/./scripts/convert_yaml_to_adoc.py", line 144, in <module> [exec] convert(yaml_file, dest_file) [exec] File "/home/jlewandowski/dev/cassandra/trunk/doc/./scripts/convert_yaml_to_adoc.py", line 61, in convert [exec] with open(dest_file, 'w') as outfile: [exec] FileNotFoundError: [Errno 2] No such file or directory: './modules/cassandra/pages/configuration/cass_yaml_file.adoc' [exec] make: *** [Makefile:26: gen-asciidoc] Error 1 [exec] Result: 2

This seems to have been broken during the migration from rst to asciidoc.