Skip to content
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

Merged
merged 4 commits into from
Jul 12, 2023
Merged

Conversation

mariomac
Copy link
Contributor

@mariomac mariomac commented Jul 11, 2023

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:

make mermaid

This needs to be run manually after the diagram sources change.

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
Copy link
Member

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-commenter
Copy link

codecov-commenter commented Jul 11, 2023

Codecov Report

Merging #171 (176fd37) into main (e45cbef) will decrease coverage by 42.39%.
The diff coverage is n/a.

@@             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     
Flag Coverage Δ
integration-test ?
unittests 39.08% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

see 27 files with indirect coverage changes

Copy link
Contributor

@grcevski grcevski left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@mariomac mariomac merged commit 721ca7d into grafana:main Jul 12, 2023
@mariomac mariomac deleted the mermaid branch July 12, 2023 08:41
mattdurham pushed a commit to mattdurham/beyla that referenced this pull request Jan 22, 2025
* Move mermaid diagrams out of markdown files

* Moved make mermaid to root Makefile

* Moved make mermaid to the correct makefile

* fix typo
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants