-
Notifications
You must be signed in to change notification settings - Fork 119
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Move mermaid diagrams out of markdown files #171
Conversation
docs/docs.mk
Outdated
@@ -115,3 +115,7 @@ 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/docs.mk | |||
curl -s -LO https://raw.githubusercontent.com/grafana/writers-toolkit/main/docs/make-docs | |||
chmod +x make-docs | |||
|
|||
.PHONY: mermaid |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice!
I would move this to Makefile because this file is automatically updated from the centralized source in Writers' Toolkit which will wipe out your changes. Makefile is left untouched by the update process and is the place for repo specific targets.
Codecov Report
@@ Coverage Diff @@
## main #171 +/- ##
===========================================
- Coverage 81.46% 39.08% -42.39%
===========================================
Files 35 34 -1
Lines 2466 2410 -56
===========================================
- Hits 2009 942 -1067
- Misses 337 1410 +1073
+ Partials 120 58 -62
Flags with carried forward coverage won't be shown. Click here to find out more. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
* Move mermaid diagrams out of markdown files * Moved make mermaid to root Makefile * Moved make mermaid to the correct makefile * fix typo
Github automatically renders embedded mermaid diagrams but the Hugo distribution in Grafana Docs doesn't, so I moved them out of the markdown sources and added a new make target that regenerates all the PNGs:
This needs to be run manually after the diagram sources change.