#81 Tech Writer VS Coduje, czyli pisanie dokumentacji w modelu docs as code
Zapewne każdy programista zna albo przynajmniej słyszał o Visual Studio Code (VS Code), czyli darmowym edytorze ze stajni Microsoftu.
Jednak podejrzewamy, że nie każdy Tech Writer wie co to za narzędzie i że można go z powodzeniem używać do tworzenia dokumentacji. Raczej nie przyda nam się jeśli pracujemy z narzędziami typu CCMS, ale za to doskonale sprawdzi się w modelu "docs as code", w którym niepodzielnie od wielu lat króluje Markdown. Mnogość opcji konfiguracyjnych i dostępnych wtyczek sprawia, że ten edytor może okazać się świetnym wyborem dla technoskrybów, którzy ściśle współpracują z programistami.
Rozmawiamy o tym co nam oferuje VS Code, jakie wtyczki przydają się do pisania dokumentacji, jakie ciekawe funkcje można znaleźć w tym edytorze, a nawet o tym jak dodać podstawowe wsparcie dla plików DITA.
Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (creativecommons.org/license...).
Linki:
- Visual Studio Code (VS Code): code.visualstudio.com/https...
- Wtyczka MDX: marketplace.visualstudio.co...
- Wtyczka Markdown All in One: marketplace.visualstudio.co...
- Wtyczka markdownlint: marketplace.visualstudio.co...
- Wtyczka Markdown Preview Enhanced: marketplace.visualstudio.co...
- Vale: github.com/errata-ai/vale
- Wtyczka Vale VSCode: marketplace.visualstudio.co...
- Wtyczka Write Good Linter: marketplace.visualstudio.co...
- Wtyczka vscode-textlint: marketplace.visualstudio.co...
- Wtyczka Prettier - Code formatter: marketplace.visualstudio.co...
- Wtyczka Code Spell Checker: marketplace.visualstudio.co...
- Wtyczka Markdown PDF: marketplace.visualstudio.co...
- Wtyczka Gremlins tracker for Visual Studio Code: marketplace.visualstudio.co...
- Wtyczka REST Client: marketplace.visualstudio.co...
- Wtyczka GitLens — Git supercharged: marketplace.visualstudio.co...
- "Lint, Lint and Away! Linters for the English Language", Chris Chinchilla: hackernoon.com/lint-lint-an...
- "The 2025 Developer Survey", Stack Overflow: survey.stackoverflow.co/2025
- "Darwin Information Typing Architecture" (DITA), Wikipedia: en.wikipedia.org/wiki/Darwi...
- "How can I make DITA catalog.xml work in VS Code?", Stack Overflow: stackoverflow.com/questions...