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.