Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

docs-as-code

/docs-as-code

Traktuje dokumentację jak kod: trzyma ją w repozytorium, przegląda w pull requestach, sprawdza w CI i buduje podglądy, gdy dokumentacja rozjeżdża się z rzeczywistością.

Repozytorium
AI-SKILLS ↗
Licencja
MIT
Ostatnia zmiana repozytorium
05.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 05.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Traktuje dokumentację jak kod: trzyma ją w repozytorium, przegląda w pull requestach, sprawdza w CI i buduje podglądy, gdy dokumentacja rozjeżdża się z rzeczywistością.

Oryginalny opis (EN)

Treat documentation like code: in the repo, in pull requests, CI-checked, with preview builds. Use when docs drift from reality or the docs workflow is separate from the code workflow.

Jak działa

  1. Method
  2. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 66 linii, 466 słów
Podgląd SKILL.md
---
name: docs-as-code
description: "Treat documentation like code: in the repo, in pull requests, CI-checked, with preview builds. Use when docs drift from reality or the docs workflow is separate from the code workflow."
---

# Docs as code

The reason docs go stale is that they live apart from the code they
describe, changed by different people through a different process.
Docs-as-code closes that gap: documentation lives in the repo, changes
in the same pull request as the code, and CI checks it: so drift
becomes a build failure instead of a discovery months later.

## Method

1. **Keep docs in the repo, beside the code.** Markdown (or
   the docs framework's format) versioned with the source:
   the docs for a feature live next to it and change in the
   same commit. This co-location is the whole idea: the
   documentation and the code share one history, one review,
   one source of truth (see monolith-first's co-location
   instinct, applied to docs).
2. **Change docs in the same PR as the code.** A change that
   alters behavior updates the docs in the same pull request,
   reviewed together (see pull-request-size, code-review):
   the reviewer checks that the docs match the change while
   both are fresh. Separate docs-later tickets are how docs
   fall permanently behind.
3. **Check docs in CI.** Link checking (dead links fail the
   build), spell/style linting (see style-guides), and
   crucially, testing that code examples actually run (see
   api-reference-docs, tutorial-writing): a broken example
   fails CI like a broken test. Automated checks are what
   make "docs match reality" enforceable rather than
   aspirational.
4. **Build previews on every change.** A rendered preview of
   the docs per pull request (the framework deployed to a
   preview URL) lets reviewers see the actual output, not
   the raw markup: catches formatting breaks and reads the
   way users will. Reviewing docs as source is like
   reviewing a rendered UI as HTML.
5. **Generate what should be generated, write what should
   be written.** API reference from the schema (see
   api-reference-docs), CLI help from the parser, config
   options from the code: generated so they never drift;
   conceptual guides, tutorials, and rationale hand-written
   because no generator produces insight. Know which is
   which and wire the generation into the build.
6. **Lower the contribution barrier.** If fixing a typo
   requires learning a bespoke CMS, typos stay; if it is a
   markdown edit in the repo with a preview, anyone fixes
   it (see community-building's contributor ladder). The
   docs-as-code payoff includes that the whole team, not a
   docs silo, keeps docs current.

## Boundaries

- Docs-as-code fits developer-facing and technical docs
  well; end-user documentation with heavy media,
  localization, and non-technical authors may need a CMS
  or hybrid: match the tooling to who writes and reads.
- The workflow's value depends on the CI checks being real
  (tested examples, link checks): docs-in-the-repo without
  the checks is just a different place for stale docs to
  live.
- Generated docs still need curation (see
  api-reference-docs); "generate everything" produces
  complete, correct, and unhelpful reference. The method
  is generate-plus-write, both in the repo.

Wersje

W bazie nie ma innych skilli o nazwie docs-as-code.

Migawka bazy z 13.11.2026 · wersja paczki d5d7502f34e4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100update-ui-inventory
    Aktualizuje inwentarz komponentów UI i dokumentację, gdy komponenty są dodawane lub usuwane, tak by docs zgadzały się z rzeczywistością.
  • 100cpp-review
    Przegląda kod C++ pod kątem zgodności z Google C++ Style Guide, także w pull requestach.
  • 100docs-maintenance
    Chroni dokumentację przed starzeniem przez wykrywanie nieaktualności, przypisanie właścicieli, testy dokumentów i świadome wycofywanie treści, gdy dokumenty rozjechały się z rzeczywistością.
  • 100repo
    Aktualizuje dokumentację repozytorium, czyli README, docs i CLAUDE.md, na podstawie zmian z sesji.
  • 100docs-review
    Przegląda zmiany w dokumentacji pod kątem zgodności z przewodnikiem stylu pisania Metabase, w pull requestach, plikach i diffach z plikami markdown.
  • 100update-docs
    Aktualizuje publiczną dokumentację w katalogu docs/public, gdy zmieniają się funkcje albo narzędzia w projekcie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.