docs!: update to v3 style (#3324) (#3432)

fix(docs): adjust build script

docs/conf.py

@@ -65,7 +65,7 @@
     "tortoise": ("https://tortoise.github.io/", None),
     "piccolo": ("https://piccolo-orm.readthedocs.io/en/latest", None),
     "opentelemetry": ("https://opentelemetry-python.readthedocs.io/en/latest/", None),
-    "advanced-alchemy": ("https://docs.advanced-alchemy.jolt.rs/latest/", None),
+    "advanced-alchemy": ("https://docs.advanced-alchemy.litestar.dev/latest/", None),
     "jinja2": ("https://jinja.palletsprojects.com/en/latest/", None),
     "trio": ("https://trio.readthedocs.io/en/stable/", None),
 }
@@ -414,7 +414,5 @@ def delayed_setup(app: Sphinx) -> None:
 
 def setup(app: Sphinx) -> dict[str, bool]:
     app.connect("builder-inited", delayed_setup, priority=0)
-
     app.setup_extension("litestar_sphinx_theme")
-
     return {"parallel_read_safe": True, "parallel_write_safe": True}

tools/build_docs.py

@@ -27,6 +27,7 @@
 
 parser = argparse.ArgumentParser()
 parser.add_argument("--version", required=False)
+parser.add_argument("--environment", required=False)
 parser.add_argument("output")
 
 
@@ -86,7 +87,7 @@ def build(output_dir: str, version: str | None, environment: str = "local") -> N
 
 def main() -> None:
     args = parser.parse_args()
-    build(output_dir=args.output, version=args.version)
+    build(output_dir=args.output, version=args.version, environment=args.environment)
 
 
 if __name__ == "__main__":