Skip to content

Updates to the how-to guide for creating the config - #50

Open
TeresiaOlsson wants to merge 16 commits into
docs/intro-structure-configurationfrom
docs/configuration-how-to
Open

TeresiaOlsson wants to merge 16 commits into
docs/intro-structure-configurationfrom
docs/configuration-how-to

Conversation

@TeresiaOlsson

Copy link
Copy Markdown
Member

I have updated the content of the how-to guide for the configuration.

Some parts in it was wrong (for catalogs and validation) but otherwise I mostly added links and moved some things around to improve the readability and flow.

Things I found are missing that we should add:

  • What to do if you don't have unique names in your lattice but family names. This is easy and I think just a sentence is needed but I'm not sure about the current option so I didn't add it.

  • Difference between validation of configuration and validation during object creation. This is content that I need to add at other places since it's currently completely missing from the documentation. There are also some default options that needs to be changed at some places which I have assigned issues for but done yet.

  • A link is needed to documentation for the test lattice. To generate documentation for that package is also an existing issue.

@GamelinAl

Copy link
Copy Markdown
Member

For me a how-to guide is how to set-up a minimal working exemple, so I would avoid adding too many advanced concept in this page, but rather adding new pages for these concepts.

Comment thread docs/source/how-to/configuration/create-configuration.md
Comment thread docs/source/how-to/configuration/create-configuration.md Outdated
@GamelinAl

Copy link
Copy Markdown
Member

@TeresiaOlsson I updated the doc with the changes we discussed, tell me if it's good for you

@GamelinAl GamelinAl mentioned this pull request Oct 6, 2026
@TeresiaOlsson

Copy link
Copy Markdown
Member Author

@TeresiaOlsson I updated the doc with the changes we discussed, tell me if it's good for you

I will take a look at it tomorrow :)

This branch has not been deployed

No deployments
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.

2 participants