mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-10 12:47:04 +00:00
kevinveenbirkenbachandClaude Opus 5
6eb9a59d14
The Sphinx configuration, extensions and generators lived in the separate infinito-sphinx repository, whose image baked a snapshot of core at build time from a base image name core no longer publishes. Only core consumed it, and its generators read core's role layout, so the two repositories drifted without any CI covering the pair. The tooling now ships in roles/web-app-docs/files/, and web-app-sphinx is renamed to web-app-docs. The container is a small service instead of a static image: - it keeps a git mirror of the repository in the docs_sites volume; - /latest/ is the last commit of the default branch, rebuilt whenever a fetch finds a new one while the previous build stays online; - every release tag is selectable in the sidebar switcher and on /versions/, and is built the first time someone opens it, behind a progress bar; - replicas share the volume: the one holding builder.lock fetches and builds, the queue and the build states are files beside the sites, so another replica resumes the queue when the builder dies. The theme rewrites every page serially after the build, which took about 75 minutes for the 4544 pages; that pass now runs on the -j workers with the theme's own function. sphinx-apidoc skips tests/, because tests/utils/bare_bootstrap_probe.py installs an import blocker when autodoc imports it and killed the Sphinx workers. The roles overview is generated by a separate process, so autodoc resolves utils from the version being built, not from main. The role pages now show galaxy_info.description instead of the top-level key that never existed. The Sphinx packages join the dev extra, because the mirrored unit tests of the tooling import them. min_storage now budgets the built image, the latest site and a running build's scratch instead of the old image's size. The Playwright suite is split into front page, versions and on-demand build files; the last one selects an unbuilt tag in the overview and asserts the build gets queued. Operators must rename the web-app-sphinx inventory group to web-app-docs. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
45 lines
1.2 KiB
Python
45 lines
1.2 KiB
Python
from __future__ import annotations
|
|
|
|
import argparse
|
|
from pathlib import Path
|
|
|
|
README = """\
|
|
# Auto Generated Technical Documentation: {name}
|
|
|
|
This folder contains an auto-generated technical role documentation for Infinito.Nexus.
|
|
"""
|
|
|
|
|
|
def create_readme_in_subdirs(generated_dir):
|
|
"""Give every directory below ``generated_dir`` a titled ``README.md``.
|
|
|
|
Args:
|
|
generated_dir: root of the generated documentation tree.
|
|
"""
|
|
root = Path(generated_dir).resolve()
|
|
if not root.exists():
|
|
print(f"Error: Directory {root} does not exist.")
|
|
return
|
|
|
|
for subdir in [path for path in root.rglob("*") if path.is_dir()]:
|
|
readme = subdir / "README.md"
|
|
readme.write_text(README.format(name=subdir.name), encoding="utf-8")
|
|
print(f"README.md created at {readme}")
|
|
|
|
|
|
def main(argv=None):
|
|
parser = argparse.ArgumentParser(
|
|
description="Create README.md files in all subdirectories of the given directory."
|
|
)
|
|
parser.add_argument(
|
|
"--generated-dir", required=True, help="Path to the generated directory."
|
|
)
|
|
args = parser.parse_args(argv)
|
|
|
|
create_readme_in_subdirs(args.generated_dir)
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|