# Does the Docs infrastructure support any graphing syntax?

**URL:** <https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060>\
**Category:** Project Discussion\
**Tags:** docs-team\
**Created:** [August 28, 2025, 6:15pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060 "2025-08-28T18:15:01Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![rokejulianlockhart](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/rokejulianlockhart/32/52169_2.png) [@rokejulianlockhart](https://discussion.fedoraproject.org/u/rokejulianlockhart)\
**Post date:** [August 28, 2025, 6:15pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/1 "2025-08-28T18:15:01Z")

</div>

Discourse, GitLab, and Forgejo support MermaidJS for inline graphs. Does the Docs infrastructure support an equivalent? If not, might I be permitted to report this at [`gitlab.com/groups/fedora/docs/-/issues`](https://gitlab.com/groups/fedora/docs/-/issues)? I ask because I appear to be disallowed.

Similarly, I attempted to ask this in #docs-team, \[1\] but I’m not allowed to.

* * *

1. [`gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/blob/b43fd7817bfbaf4f0c698c149c4b523f8d58031c/modules/ROOT/pages/index.adoc?plain=1#L77`](https://gitlab.com/fedora/docs/community-tools/documentation-contributors-guide/-/blob/b43fd7817bfbaf4f0c698c149c4b523f8d58031c/modules/ROOT/pages/index.adoc?plain=1#L77:~:text=https://discussion.fedoraproject.org/tag/-,docs%2Dteam,-IRC%20channel::)

---

<div class="post-metadata">

**Author:** ![py0xc3](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/py0xc3/32/3378_2.png) [@py0xc3](https://discussion.fedoraproject.org/u/py0xc3)\
**Post date:** [August 28, 2025, 6:31pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/4 "2025-08-28T18:31:33Z")

</div>

> [@rokejulianlockhart](#):
>
> Similarly, I attempted to ask this in #docs-team, [[1]](#footnote-431697-1) but I’m not allowed to

I changed it for you. Though I wonder that you cannot use the #docs-team tag → did you try to use that tag in the Project Discussion category or in ask.fedora? I ask as that tag is intended only for Project Discussion, which is the place where the Docs team organizes itself. So if you tried to use the #docs-team tag in ask.fedora (which only knows #docs ), then that might explain the issue.

---

<div class="post-metadata">

**Author:** ![py0xc3](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/py0xc3/32/3378_2.png) [@py0xc3](https://discussion.fedoraproject.org/u/py0xc3)\
**Post date:** [August 28, 2025, 6:36pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/5 "2025-08-28T18:36:16Z")

</div>

Docs team, does it make sense to get rid of the #docs tag in ask.fedora? I am not sure if it makes sense to have a tag there, I presume it is not intended for use anyway by you, and I assume you prefer “questions” around Docs (like this one) to be discussed in #docs-team within project discussion anyway, don’t you? If you agree, I can delete it for you, to decrease the likelihood of confusion in future and to avoid that people ask stuff about Docs in ask.fedora without you noticing it (I here presume that the ask-fedora #docs tag is not followed). Let me know if I shall delete it :classic_smiley:

---

<div class="post-metadata">

**Author:** ![rokejulianlockhart](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/rokejulianlockhart/32/52169_2.png) [@rokejulianlockhart](https://discussion.fedoraproject.org/u/rokejulianlockhart)\
**Post date:** [August 28, 2025, 8:18pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/6 "2025-08-28T20:18:40Z")

</div>

> [@py0xc3](#):
>
> if you tried to use the #docs-team tag in ask.fedora (which only knows #docs ), then that might explain the issue.

@py0xc3, I did. Thanks. I’ve suggested, upstream, that the error be more actionable:

> **[Provide more actionable error messages when a user attempts to utilise a tag...](https://meta.discourse.org/t/provide-more-actionable-error-messages-when-a-user-attempts-to-utilise-a-tag-in-category-which-that-tag-isnt-allowed-in/380814?u=rokejulianlockhart)**
>
> As an example, see: Discourse should recommend that I utilise the correct category, rather than merely inform me that the tag is disallowed.

---

<div class="post-metadata">

**Author:** ![pbokoc](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/pbokoc/32/231_2.png) [@pbokoc](https://discussion.fedoraproject.org/u/pbokoc)\
**Post date:** [September 1, 2025, 9:47am UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/7 "2025-09-01T09:47:29Z")

</div>

Hi, yeah, I always thought it was odd that we had both docs and docs-team - it just never bugged me enough to actually try to do anything about it. If you can get rid of docs, that would be great.

---

<div class="post-metadata">

**Author:** ![py0xc3](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/py0xc3/32/3378_2.png) [@py0xc3](https://discussion.fedoraproject.org/u/py0xc3)\
**Post date:** [September 1, 2025, 11:16am UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/8 "2025-09-01T11:16:37Z")

</div>

> [@pbokoc](#):
>
> If you can get rid of docs, that would be great.

Done :classic_smiley:

---

<div class="post-metadata">

**Author:** ![pbokoc](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/pbokoc/32/231_2.png) [@pbokoc](https://discussion.fedoraproject.org/u/pbokoc)\
**Post date:** [September 1, 2025, 11:23am UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/9 "2025-09-01T11:23:08Z")

</div>

@rokejulianlockhart No, unfortunately we don’t have support for that at the moment.

Forgejo might, so when we migrate… well, our docs aren’t built by the git forge (pagure, gitlab, etc.) and won’t be by Forgejo either, but we might be able to set up Forgejo builds in certain repos that would output static images which could then be included in the docs.

Also, re: permissions for the docs group in Gitlab - the link you posted is just the sum of all issues in a bunch of separate repos, so there’s no way to open an issue there. Can you open an issue here? [Issues · Fedora / Fedora Docs / Docs Website / Fedora Docs Website · GitLab](https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/issues/)

---

<div class="post-metadata">

**Author:** ![rokejulianlockhart](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/rokejulianlockhart/32/52169_2.png) [@rokejulianlockhart](https://discussion.fedoraproject.org/u/rokejulianlockhart)\
**Post date:** [September 1, 2025, 11:34am UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/10 "2025-09-01T11:34:10Z")

</div>

> [@pbokoc](#):
>
> > [@rokejulianlockhart](#):
> >
> > Might I be permitted to report this at [`gitlab.com/groups/fedora/docs/-/issues`](https://gitlab.com/groups/fedora/docs/-/issues)? I ask because I appear to be disallowed.
> 
> the link you posted is just the sum of all issues in a bunch of separate repos, so there’s no way to open an issue there. Can you open an issue here? [Issues · Fedora / Fedora Docs / Docs Website / Fedora Docs Website · GitLab](https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/issues/)

@pbokoc, I am able to. Have you any idea why my originally linked superordinate doesn’t provide the indication of this that its subordinates do?

1. 
#### `fedora/docs/docs-website/-/issues`

![image](https://us1.discourse-cdn.com/fedoraproject/optimized/3X/1/7/17e6d96deab757ab8f48dafe16505e788b17ebfc_2_690x25.png)

2. 
#### `fedora/docs/-/issues`

![image](https://us1.discourse-cdn.com/fedoraproject/optimized/3X/c/6/c64c8b10d0ceea9d18265b0de59c9c554e0eeb35_2_690x25.png)

If you’ve no idea, I’ll ask at [`forum.gitlab.com/new-topic`](https://forum.gitlab.com/new-topic), then file an issue upstream, at [`gitlab.com/gitlab-org/gitlab/-/issues`](https://gitlab.com/gitlab-org/gitlab/-/issues).

* * *

> [@pbokoc](#):
>
> we might be able to set up Forgejo builds in certain repos that would output static images which could then be included in the docs.

If that can be tracked, I’d _like_ it to be. Otherwise, I’ll forget.

---

<div class="post-metadata">

**Author:** ![pbokoc](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/pbokoc/32/231_2.png) [@pbokoc](https://discussion.fedoraproject.org/u/pbokoc)\
**Post date:** [September 1, 2025, 12:14pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/11 "2025-09-01T12:14:07Z")

</div>

> [@rokejulianlockhart](#):
>
> If you’ve no idea, I’ll ask at [`forum.gitlab.com/new-topic`](https://forum.gitlab.com/new-topic), then file an issue upstream, at [`gitlab.com/gitlab-org/gitlab/-/issues`](https://gitlab.com/gitlab-org/gitlab/-/issues).

Yeah, I have no idea 🙂

> [@rokejulianlockhart](#):
>
> If that can be tracked, I’d _like_ it to be. Otherwise, I’ll forget.

I opened an issue for it here: [RFE: Implement a way to use MermaidJS or some other diagramming solution in docs (#14) · Tasks · Fedora / Fedora Docs / Docs Website / Fedora Docs Website · GitLab](https://gitlab.com/fedora/docs/docs-website/docs-fp-o/-/issues/14)

---

<div class="post-metadata">

**Author:** ![rokejulianlockhart](https://sea1.discourse-cdn.com/fedoraproject/user_avatar/discussion.fedoraproject.org/rokejulianlockhart/32/52169_2.png) [@rokejulianlockhart](https://discussion.fedoraproject.org/u/rokejulianlockhart)\
**Post date:** [September 1, 2025, 3:16pm UTC](https://discussion.fedoraproject.org/t/does-the-docs-infrastructure-support-any-graphing-syntax/163060/12 "2025-09-01T15:16:17Z")

</div>

@pbokoc, thanks:

> **[Why do groups that aren't immediate or ultimate suprordinare lack the issue...](https://forum.gitlab.com/t/why-do-groups-that-arent-immediate-or-ultimate-suprordinare-lack-the-issue-creation-button/130150?u=rokejulianlockhart)**
>
> I’ll file an issue upstream (at gitlab.com/gitlab-org/gitlab/-/issues) if nobody knows, for I expect that it’s not deliberate. Problem to solve At gitlab.com/groups/fedora/-/issues, I see: At groups/fedora/docs’s: At...
