Improving documentation

[reinkrul]

Documentation is scattered

We have:

• formal Nuts node documentation on read the docs (https://nuts-node.readthedocs.io/en/stable/index.html)
• instruction manuals on the wiki (https://wiki.nuts.nl/shelves/manuals-tutorials-and-guides)
• formal Nuts specifications on GitBook: https://nuts-foundation.gitbook.io/v1
• use cases:
  • some use case specifications on GitBook: https://nuts-foundation.gitbook.io/bolts
  • other use case specifications on the wiki (huisartsinzage): https://wiki.nuts.nl/books/samenwerken-huisarts-en-thuiszorg/page/zorgtoepassing-ha-vvt-inzage-dossier-v10
  • some other live on other external spaces: https://babyconnect.atlassian.net/wiki/spaces/VBC/pages/1147535373/Technische+Afspraak+Zorginzage+Geboortezorg
• other resources here and there (e.g. important policy files live in https://github.com/nuts-foundation/hackathon-resources)

Latest documentation is missing v5/gRPC network documentation

Basic usage flows not documented

The most basic usage flows (request & use access token, introspect access token) are not documented.
Although there's documentation on the wiki: https://wiki.nuts.nl/books/implementing-a-nuts-use-case/page/requesting-access-outbound