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.

Gerelateerde gidspadenAI voor technische schrijvers
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.

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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