Útmutatóhoz kapcsolódó kvíz · Közepes Szint

AI technikai írók kvíz

Teszteli a mesterséges intelligencia által támogatott dokumentációt: docs-as-code Vale-el és CI-vel, Diátaxis tartalomtípusokat, tesztelési kódmintákat és dokumentumok írását az AI lekéréséhez.

Kapcsolódó útmutató utakAI műszaki íróknak
kérdés 1 -ból 8

Mit csinál a Vale-linter a docs-as-code munkafolyamatban?

Tekintse meg az összes kérdést8 kérdéseket

A válaszok és magyarázatok megjelennek a kvíz kitöltésekor.

  1. Mit csinál a Vale-linter a docs-as-code munkafolyamatban?
    • Generates API reference pages from code
    • Hosts the documentation website
    • Checks prose against style-guide rules and gives the same result every time
    • Translates docs into other languages
  2. Mi írja le legjobban a docs-as-code-ot?
    • Documentation kept in version control and reviewed and built like code
    • Writing documentation only inside code comments
    • Using AI to write all docs automatically
    • Publishing documentation as PDF only
  3. Melyik négy tartalomtípust választja el a Diátaxis keretrendszer?
    • Blogs, emails, slides and videos
    • Tutorials, how-to guides, reference and explanation
    • Drafts, reviews, approvals and archives
    • Beginner, intermediate, advanced and expert
  4. Miért kell az AI által generált kódmintákat tesztként futtatni?
    • Tests make pages load faster
    • Search engines require tested code
    • Testing replaces the need for a style guide
    • Models can invent plausible parameters or flags, and tests catch them before readers do
  5. Mi az llms.txt javaslat?
    • A suggested file that points language models to a site's key documentation
    • A legal license for AI training
    • A style guide published by Microsoft
    • A required format for all API specs
  6. Which writing practice helps AI assistants that retrieve documentation?
    • Long pages with no headings
    • Frequent references like 'as mentioned above'
    • Self-contained sections with descriptive headings and explicit product names
    • Putting all content in images
  7. How was API reference documentation commonly produced before generative AI?
    • It was always written entirely by hand
    • It was generated from specs or code comments with tools such as Swagger UI, Redoc or Sphinx autodoc
    • It did not exist
    • It was produced by speech recognition
  8. According to the guide, where does a technical writer add the most value alongside AI?
    • Typing faster than the model
    • Avoiding version control
    • Removing all human review
    • Checking accuracy, deciding what users need and structuring information