From 73b79ff1dbc0dde5a5d5e3bdff951f6f0b8e3562 Mon Sep 17 00:00:00 2001 From: Pedro Brochado Date: Thu, 16 Jul 2026 18:17:37 -0300 Subject: [PATCH 1/2] Enabled livereload by default in serve command Click 8.x resolves duplicate-named flag params incorrectly, causing livereload to silently default to False. --- src/pulp_docs/cli.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/pulp_docs/cli.py b/src/pulp_docs/cli.py index f6994f8..227b642 100644 --- a/src/pulp_docs/cli.py +++ b/src/pulp_docs/cli.py @@ -226,4 +226,8 @@ def get_default_mkdocs() -> Path | None: config_file_opt.envvar = "PULPDOCS_DIR" config_file_opt.default = get_default_mkdocs() -openapi_option(main.commands.get("serve")) +# Enable livereload by default +serve_cmd = main.commands.get("serve") +livereload_opt = next(filter(lambda opt: opt.name == "livereload", serve_cmd.params)) +livereload_opt.default = True +openapi_option(serve_cmd) From 9c6f408172d357383240f8de2592dcb18c369738 Mon Sep 17 00:00:00 2001 From: Pedro Brochado Date: Thu, 16 Jul 2026 18:19:44 -0300 Subject: [PATCH 2/2] Add make serve target for local development --- Makefile | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Makefile b/Makefile index 55d4e47..8910f67 100644 --- a/Makefile +++ b/Makefile @@ -85,6 +85,12 @@ endif $(DOCS_IMAGE) \ /pulp-docs/ci/scripts/build_docs_ci.sh $(COMPONENT) +.PHONY: serve +serve: + uv run --isolated pulp-docs serve \ + --draft \ + --path pulp-docs@.. + .PHONY: clean clean: