Gids-gekoppelde quiz · Middelmatig Niveau
AI voor technische schrijversquiz
Test door AI ondersteunde documentatie: docs-as-code met Vale en CI, Diátaxis-inhoudstypen, testen van codevoorbeelden en schrijven van documenten voor het ophalen van AI.
Vraag 1 van 8
Wat doet de Vale-linter in een docs-as-code-workflow?
Bekijk elke vraag8 vragen
Antwoorden en uitleg verschijnen terwijl je de quiz doet.
- Wat doet de Vale-linter in een docs-as-code-workflow?
- Genereert API-referentiepagina's vanuit code
- Hostt de documentatiewebsite
- Controleert proza op stijlrichtlijnen en geeft elke keer hetzelfde resultaat
- Vertaal documenten naar andere talen
- Wat beschrijft docs-as-code het beste?
- Documentatie bewaard in versiebeheer en beoordeeld en gebouwd als code
- Documentatie schrijven alleen binnen codecommentaren
- AI gebruiken om alle documenten automatisch te schrijven
- Documentatie publiceren alleen als PDF
- Welke vier inhoudstypen onderscheidt het Diátaxis-framework?
- Blogs, e‑mails, dia's en video's
- Tutorials, handleidingen, referenties en uitleg
- Concepten, beoordelingen, goedkeuringen en archieven
- Beginner, gemiddeld, gevorderd en expert
- Waarom moeten door AI gegenereerde codevoorbeelden als tests worden uitgevoerd?
- Tests maken pagina's sneller laden
- Zoekmachines vereisen geteste code
- Testen vervangen de noodzaak voor een stijlgids
- Modellen kunnen plausibele parameters of vlaggen verzinnen, en tests vangen ze op voordat lezers dat doen
- Wat is het llms.txt-voorstel?
- Een voorgesteld bestand dat taalmodellen naar de belangrijkste documentatie van een site wijst
- Een wettelijke licentie voor AI-training
- Een stijlgids gepubliceerd door Microsoft
- Een vereiste opmaak voor alle API-specificaties
- Welke schrijfpraktijk helpt AI-assistenten die documentatie ophalen?
- Lange pagina's zonder koppen
- Frequent references like 'as mentioned above'
- Zelfstandige secties met beschrijvende koppen en expliciete productnamen
- Alle inhoud in afbeeldingen plaatsen
- Hoe werd API-referentiedocumentatie gewoonlijk geproduceerd vóór generatieve AI?
- Het werd altijd volledig met de hand geschreven
- Het werd gegenereerd uit specificaties of codecommentaren met tools zoals Swagger UI, Redoc of Sphinx autodoc
- Het bestond niet
- Het werd geproduceerd door spraakherkenning
- Volgens de gids, waar voegt een technisch schrijver de meeste waarde toe naast AI?
- Sneller typen dan het model
- Versiebeheer vermijden
- Alle menselijke beoordeling verwijderen
- Nauwkeurigheid controleren, bepalen wat gebruikers nodig hebben en informatie structureren