From cf624a6cf0eda829a7220893d03b2b75c41f2798 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 19 Feb 2025 09:54:01 +0000 Subject: [PATCH] Update `make docs` procedure (#100945) Co-authored-by: grafanabot Co-authored-by: Jack Baldry --- docs/docs.mk | 4 +++- docs/make-docs | 6 ++++++ 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/docs.mk b/docs/docs.mk index 68a00fcf6e0..dfb6e9e501c 100644 --- a/docs/docs.mk +++ b/docs/docs.mk @@ -121,7 +121,9 @@ update: ## Fetch the latest version of this Makefile and the `make-docs` script curl -s -LO https://raw.githubusercontent.com/grafana/writers-toolkit/main/docs/make-docs chmod +x make-docs -.PHONY: topic/% +# ls static/templates/ | sed 's/-template\.md//' | xargs +TOPIC_TYPES := concept multiple-tasks reference section task tutorial visualization +.PHONY: $(patsubst %,topic/%,$(TOPIC_TYPES)) topic/%: ## Create a topic from the Writers' Toolkit template. Specify the topic type as the target, for example, `make topic/task TOPIC_PATH=sources/my-new-topic.md`. topic/%: $(if $(TOPIC_PATH),,$(error "You must set the TOPIC_PATH variable to the path where the $(@F) topic will be created. For example: make $(@) TOPIC_PATH=sources/my-new-topic.md")) diff --git a/docs/make-docs b/docs/make-docs index a81ec7530f3..80c89aea7ce 100755 --- a/docs/make-docs +++ b/docs/make-docs @@ -8,6 +8,12 @@ # [Semantic versioning](https://semver.org/) is used to help the reader identify the significance of changes. # Changes are relevant to this script and the support docs.mk GNU Make interface. # +# ## 8.5.1 (2025-02-18) +# +# ### Fixed +# +# - PHONY declaration for topic/ targets. +# # ## 8.5.0 (2025-02-13) # # ### Added