Hulp vinden en zien wat er veranderde

Deze handleiding zit ín het paneel: je hoeft er niet voor naar een andere website, en hij werkt ook als je offline op je telefoon kijkt. Dezelfde teksten staan bovendien op een openbare site, zodat je een link kunt sturen aan iemand die (nog) geen account heeft. Deze pagina legt uit waar hulp staat, hoe je zoekt, en waar je ziet wat er in het paneel is veranderd.

Waar hulp staat

Op elke pagina, altijd op dezelfde plek:

• Hulp bij deze pagina — het icoon rechtsboven, of gewoon de toets ?. Er schuift een paneeltje open met precies het artikel dat over het scherm gaat waar je op staat. Onderaan staat Open de volledige handleiding, als je liever met de navigatie ernaast verder leest.
• Handleiding — onderin het zijmenu en rechtsboven. Dat is het overzicht van alle onderwerpen.
• ⌘K (of Ctrl+K) opent het commandopalet. Dat doorzoekt de navigatie én de handleiding tegelijk: typ "mailbox" en je krijgt zowel de pagina als het artikel.

Hoe een artikel eruitziet

Een artikel heeft drie kolommen, en elk van de drie doet iets:

• links de onderwerpen. De groep waar je in zit staat open en het artikel dat je leest is gemarkeerd, dus je ziet altijd waar je bent.
• midden de tekst, in een vaste leesbreedte. Dat is met opzet niet de volle schermbreedte: een regel van 150 tekens is precies waarom lange documentatie vermoeiend leest.
• rechts Op deze pagina, met de kopjes van het artikel. Terwijl je scrollt licht het kopje op waar je nu bent. Op een smal scherm valt deze kolom weg en wordt de linkerkolom een uitklapbaar menu.

Boven de tekst staat het pad (Handleiding › onderwerp › artikel) en onderaan staan Vorige en Volgende, zodat je een onderwerp in één ruk kunt doorlezen.

Codeblokken hebben een kopieerknop; blokken die een transcriptie zijn (het commando met de uitvoer eronder) niet, want die kopieer je toch niet.

Zoeken

Het zoekveld boven de handleiding doorzoekt alle artikelen: de titels, de kopjes en de tekst zelf. Meerdere woorden werken als "allemaal aanwezig", dus wordpress staging vindt de pagina die over allebei gaat en niet elke pagina die WordPress noemt. Vindt hij niets, dan zegt hij dat — je krijgt geen lijst met alles alsof je niets had ingetypt.

Het zoeken gebeurt in je browser. Er gaat niets naar een zoekdienst en er is niets dat eerst opgehaald moet worden: de handleiding zit in het paneel zelf.

Je ziet de artikelen die bij jou horen

De handleiding filtert zichzelf op jouw soort account:

• ben je een hostingklant, dan zie je de artikelen voor klanten;
• ben je reseller, dan zie je die van je klanten er ook bij — want jij beantwoordt hun vragen;
• ben je beheerder, dan zie je alles.

Rechtsboven de handleiding staat een keuzelijst waarmee je dat kunt omzetten: Toon alles, of Bekijk als klant om te zien wat jouw klanten zien. Handig als je iemand aan de telefoon hebt.

Open je een artikel dat voor een hoger niveau is geschreven, dan krijg je geen "pagina bestaat niet", maar het artikel met een blok erboven dat zegt voor wie het geschreven is en wat je kunt doen. Dat is eerlijker dan doen alsof de uitleg niet bestaat.

Nederlands en Engels

Elk artikel bestaat in beide talen. Wissel je van taal, dan blijf je op hetzelfde artikel staan — je springt niet terug naar het overzicht. Je taalkeuze staat in Instellingen.

De openbare handleiding

Dezelfde artikelen staan openbaar op docs.corecp.dev, zonder inloggen. Dat is de link die je aan een klant of aan iemand die nog geen account heeft kunt sturen. De openbare site draagt de huisstijl van het merk waarvan je de hostnaam gebruikt: heeft je hostingpartij een eigen naam en kleur, dan staat die daar ook.

# Elk artikel heeft een vaste, deelbare link, per taal:
curl -sI https://docs.corecp.dev/nl/e-mail-instellen | head -1
curl -sI https://docs.corecp.dev/en/setting-up-email | head -1

Wat er veranderde

Onder Wat is er veranderd (of via de versie onderin het zijmenu) staan de release-notities. Links staat de lijst met versies, nieuwste eerst, met bovenaan Nog niet uitgebracht — dat is werk dat al in het paneel zit maar nog niet onder een versienummer is gesneden.

Kies je een versie, dan zie je rechts wat erin zit:

• eerst alles wat actie vereist — dingen die je moet weten vóór je bijwerkt, met een rood label;
• daarna de wijzigingen gegroepeerd per soort: Toegevoegd, Gewijzigd, Gefixt, Verwijderd, Verouderd en Beveiliging;
• met een filter op soort en een zoekveld, als een release groot is.

Elke versie heeft een eigen adres, dus je kunt er rechtstreeks naar linken: /changelog/0.15.0. In de versielijst staat ook welke versie je op dit moment draait.

Eén zin per wijziging, de details uitklapbaar

Elke wijziging begint met één regel in gewone taal: wat er anders is, en verder niets. Geen bestandsnamen, geen commando's, geen nummers van interne meldingen. Dat is met opzet — je moet in één blik kunnen zien of een release iets voor jou verandert.

Beheer je zelf een server, dan staat onder zo'n regel vaak Details voor beheerders. Klik erop en het blok klapt uit met de technische kant van dezelfde wijziging: het commando dat erbij hoort, het adres dat wijzigde, of wat je vóór het bijwerken moet doen. Klap je het niet uit, dan zie je er niets van. Zo is er één lijst met wijzigingen voor iedereen, in plaats van twee lijsten die uit elkaar gaan lopen.

De blokken openen met een muisklik en met de toetsen (tab naar het kopje, Enter), en ze blijven open zolang je op de pagina bent. Zoek je in het zoekveld boven de lijst, dan zoekt hij ook in de tekst die nog ingeklapt staat.

Hoe vaak er een versie bijkomt

Elke afgeronde brok werk krijgt een eigen nummer, en een reeks daarvan wordt samen een grotere versie. Praktisch betekent dat: het nummer achteraan (0.16.1 → 0.16.2) verandert vaak en gaat over één stuk werk, het nummer in het midden (0.16.0 → 0.17.0) verandert als een hele ronde af is. Zie je een versie met een ~dev erin, dan kijk je naar een paneel dat middenin een wijziging staat — op een productie-paneel hoort dat niet te gebeuren.

Onderin het zijmenu staat altijd de versie die je nu draait, en in de versielijst is diezelfde versie gemarkeerd met Dit draait er nu. Dat is het nummer dat je erbij zegt als je ergens een vraag over stelt.

Mist er iets?

Ontbrekende uitleg in de handleiding is een bug, geen omissie. Meld het bij je hostingpartij — die kan een artikel toevoegen; de handleiding en de release-notities worden namelijk uit dezelfde bron opgebouwd als het paneel zelf. Beheer je het paneel zelf, dan staat de werkwijze (waar de artikelen staan, hoe je de generatoren draait en hoe een versie gesneden wordt) in de ontwikkelaarsdocumentatie: docs/development.md.

Zie ook

• Aanmelden, wisselen en je weg vinden
• Installeren op je telefoon