Public datasets for documentation

[Febakke]

[Barsnes]

A possible solution to this is pure markdown (not mdx) files in our github repo.
It would be best if this is in a separate repo, to make sure we don't move these files later.

This makes it possible for consumers on the documentation to get the raw text contents of the file, and then serve wherevery they want.

[Oskar-Andersson]

I believe there are a set of "common" questions for all users (or should I say extenders) of designsystemet.no that will need answering again and again. We that are extending our own components with designsystemet.no components face difficulties in how to arrange and maintain or even create a coherent bespoke own documentation. I am trying to formulate these as questions and perhaps you can have a look at maybe creating documentation around this?

1. We have own components and we use designsystemet.no components. We need documentation internally for designers and for new members of our teams on what we use to build our apps. How can we solve in a systematic and efficient way our own documentation needs while combining that documentation with designsystemet.no documentation (including our own colors and type information) in one "bespoke" usable "documentation" - since we use both own components and components from designsystemet.no mixed?

2. How do we best document components that are composites of designsystemet.no components and our own components - any best practices or ideas?

3. Whats the best system for documentation? You have created a full site with navigation, is your recommendation that we all create similar projects for our needs, to keep some level of coherency and UU in our own documentation vs that of designsystemet.no? If so, what system are you using and are there any docs to follow to create a similar setup?

Id like to also comment that from where I am sitting, most of "us" aren't as resource strong as designsystemet.no - so if the process to create this docs site is heavy, it might be overkill for many smaller actors.