Skip to content

Latest commit

 

History

History
 
 

docs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
architecture
architecture
 
 
best-practices
best-practices
 
 
images
images
 
 
mermaid-diagrams-source
mermaid-diagrams-source
 
 
observability
observability
 
 
slos
slos
 
 
utilities
utilities
 
 
README.md
README.md
 
 
access-control.md
access-control.md
 
 
adding-a-new-config-module.md
adding-a-new-config-module.md
 
 
adding-a-new-endpoint.md
adding-a-new-endpoint.md
 
 
adding-new-flags.md
adding-new-flags.md
 
 
admin-api-overview.md
admin-api-overview.md
 
 
automated-testing.md
automated-testing.md
 
 
best-practices.md
best-practices.md
 
 
configuring-metrics-federate-scrape-target.md
configuring-metrics-federate-scrape-target.md
 
 
data-plane-osd-cluster-options.md
data-plane-osd-cluster-options.md
 
 
deploying-kas-fleet-manager-to-openshift.md
deploying-kas-fleet-manager-to-openshift.md
 
 
deploying-observability-remote-write-proxy-in-openshift.md
deploying-observability-remote-write-proxy-in-openshift.md
 
 
feature-flags.md
feature-flags.md
 
 
getting-credentials-and-accounts.md
getting-credentials-and-accounts.md
 
 
implementation.md
implementation.md
 
 
interacting-with-fleet-manager.md
interacting-with-fleet-manager.md
 
 
jwt-claims.md
jwt-claims.md
 
 
populating-configuration.md
populating-configuration.md
 
 
quota-management-list-configuration.md
quota-management-list-configuration.md
 
 
test-locally-with-fleetshard-sync.md
test-locally-with-fleetshard-sync.md
 
 
testing.md
testing.md
 
 

README.md

Adding diagrams using mermaid

If diagrams are needed, you can either create them using the tools you like to use, or you can use mermaid to generate diagrams using Markdown-like syntax.

Unfortunately preview of mermaid diagrams is not supported by Github yet. There are supposed to be some browser extension to make it work, but they doesn't seem to be able to render the diagrams correctly in PR views. So for now we will use generated images instead.

To add a diagram generated by mermaid, you should:

  1. Add the mermaid Markdown file in the mermaid-diagrams-source directory. Make sure the filename is using .mmd extension.
  2. In the root of the project, run the following command: 
    make docs/generate/mermaid
    It will download the mermaid CLI docker container and generate the diagrams.
  3. Insert the image to your doc.