Handleiding
De handleiding bevat uitleg over de structuur van de wiki, hoe je kan bijdragen en wat de spelregels zijn. Weet je nog niet waar je iets wil toevoegen? Lees dan eerst de pagina over structuur door. Wil je hulp bij het editen? Kijk dan onder editor.
Welkom
Welkom op de Nuts Wiki!
Doel
Het doel van deze wiki is het ondersteunen van de community met een toegankelijke plek voor het vastleggen en delen van informatie.
Als community hebben we veel kennis over zeer uiteenlopende onderwerpen. Het delen van deze kennis is cruciaal bij het bereiken van onze doelen: frictieloze informatie-uitwisseling in de zorg en aangrenzende domeinen.
Hoe meer mensen deze kennis kunnen inzien en op de hoogte zijn van de uitgangspunten, hoe meer mensen kunnen meewerken aan het behalen van de doelen. Daarbij lopen we als community tegen schaalbaarheidsproblemen aan. Experts op een kennisdomein zijn niet altijd beschikbaar voor 1 op 1 gesprekken. Daarom kunnen we deze kennis het beste vastleggen en inzichtelijk maken voor iedereen. We kiezen daarbij de vorm van een wiki. Wiki artikelen zijn makkelijk in te zien maar ook aan te passen en aan te vullen. Zo houden we de kennis actueel.
Account aanvragen
Iedereen die actief is op de Nuts Slack kan inloggen op deze wiki en informatie toevoegen. Aanmelden voor de Nuts Slack kan via de Nuts website.
Structuur
De wiki maakt gebruik van de concepten shelves (planken), books (boeken) en pages (pagina's). Pagina's kunnen dan weer gegroupeerd worden onder een chapter (hhofdstuk). Net zoals bij gewone boeken zou je kunnen zeggen. In deze wiki moet de content op een pagina. Pagina's moeten in een boek en boeken moeten op een plank. Het is niet mogelijk om losse pagina's of boeken te maken.
Het is belangrijk dat er een duidelijk overzicht is van de planken en de boeken op een plank. Binnen een boek is het vrij makkelijk navigeren van pagina naar pagina. Het is dus erg onhandig als relevante informatie niet in hetzelfde boek staat.
Informatie over hoe om te gaan met planken, boeken en pagina's is te vinden op documentatie van de software: Bookstack
Shelves
Om iedereen op weg te helpen hebben we de planken alvast gedefinieerd. Het is in principe niet de bedoeling dat deze indeling wordt veranderd. Ben je het er niet mee eens of heb je vragen/opmerkingen, dan kan je terecht in het #wiki channel op de nuts Slack . De volgende paragrafen geven uitleg over de verschillende planken.
De Nuts wiki
De Nuts wiki plank bevat informatie over deze wiki. Denk aan handleidingen, uitleg over de structuur en tips over het gebruik van bepaalde termen.
Over Nuts
Op de plank Over Nuts is informatie te vinden over de organisatie structuur en governance. Een belangrijk onderdeel hiervan is de eenheid van taal: wat bedoel je met Nuts? De community, de software, de stichting of het netwerk? Tenslotte bevat de plank informatie over de financiering en eventuele sponsering.
Generieke functies
De plank Generieke functies bevat alle informatie over hoe Nuts zich relateert tot de generieke functies of hoe Nuts hier invulling aangeeft. Onder de generieke functies vallen onder andere identificatie, authenticatie, autorisatie en lokalisatie.
Books
Een boek bevat een opzichzelfstaand onderwerp met informatie verspreid over meerdere hoofdstukken/pagina's. Als je aanvullingen hebt voor de wiki, kijk dan ook altijd eerst of het in een bestaand boek kan. Binnen een boek is het makkelijk navigeren tussen pagina's en hoofdstukken. Het navigeren over boeken is minder overzichtelijk.
Pages
Pagina's bevatten de echte informatie. Een pagina op de wiki is niet te vergelijken met een pagina van een papieren boek. Bij een digitale pagina is het natuurlijk mogelijk om naar beneden te scrollen. Toch is het niet de bedoeling om pagina's mega lang te maken. Een kantje of 3 is de max. Wat goed is om te onthouden, is dat andere pagina's zullen verwijzen naar een pagina. Het is frusterend voor een gebruiker om lang te moeten zoeken op een pagina naar de gewenste informatie.
Editor
Het maken van pagina's gaat met behulp van een zogenaamde wysiwyg editor. Dit staat voor What You See Is What You Get. Aan de linkerkant is de invoer en aan de rechterkant is een voorbeeld van hoe het er uit gaat zien.
De editor bevat geen opties zoals je misschien gewend bent in Word. Dit zorgt er voor dat de pagina's een uniforme weergave krijgen. In plaats van een rijke editor wordt er gebruik gemaakt van Markdown. Markdown is een vrij eenvoudige manier van opmaak toevoegen aan een stuk tekst.
De link hierboven geeft een uitgebreidere uitleg over Markdown. Hieronder volgen een aantal van de meeste gebruikte opties. Je kan natuurlijk ook bij een bestaande pagina afkijken hoe het daar gedaan is.
italic
*italic*
bold
**bold**
[link](https://example.com)
- list 1
- list 2
- list 3
- list 1
- list 2
- list 3
Header 1
# Header 1
Header 2
## Header 2
Header 3
### Header 3