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

Docs/mermaid #974

Open
wants to merge 25 commits into
base: main
Choose a base branch
from
Open

Docs/mermaid #974

wants to merge 25 commits into from

Conversation

nhoening
Copy link
Contributor

@nhoening nhoening commented Feb 8, 2024

Description

In #953 (see #953 (comment)) we saw we would like to start using Mermaid in our docs.

I have tried that, following the instructions at https://github.com/mgaitan/sphinxcontrib-mermaid, but I could not get mermaid to build anything (yes, I ran pip install sphinxcontrib-mermaid, and I also tried the simple example diagram from their website).

Look & Feel

Running make update-docs and then going to Concepts -> The FlexMeasures Data Model should show a diagram.

How to test

In addition to the local test above, this should also work on ReadTheDocs.

nhoening and others added 23 commits January 3, 2024 18:49
…d beneftis and smart functionality pages

Signed-off-by: Nicolas Höning <nicolas@seita.nl>
… in my eyes) and rework it throughout (adding Docker steps in paralell)

Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
…V2G/flex-model illustration to tutorials

Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
…ome docs didn't have the 'Or' in there

Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: F.N. Claessen <felix@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
…/flexmeasures into docs/refactoring-scheduling
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
@nhoening nhoening added the documentation Improvements or additions to documentation label Feb 8, 2024
@Flix6x Flix6x changed the base branch from main to docs/refactoring-scheduling February 8, 2024 16:34
Base automatically changed from docs/refactoring-scheduling to main February 15, 2024 15:58
@Flix6x
Copy link
Contributor

Flix6x commented Mar 11, 2024

The current PR description suggests a tech spike with a negative outcome. What's the next decision to be taken to advance the state of this PR?

Signed-off-by: Nicolas Höning <nicolas@seita.nl>
Signed-off-by: Nicolas Höning <nicolas@seita.nl>
@nhoening
Copy link
Contributor Author

I don't know. Maybe someone has a bit of knowledge of mermaid and/or Sphinx and wants to pick this up. It would be nice to use mermaid diagrams in our docs, but not a blocker.

@nhoening nhoening added the good first issue Good for newcomers label Mar 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation good first issue Good for newcomers
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants