Na pierwszy rzut oka pisanie dokumentacji ma niewiele wspólnego z frontend developmentem. Kiedy jednak spojrzymy na nowoczesną dokumentację do oprogramowania to możemy odnieść wrażenie, że tak naprawdę niewiele różni się ona od zwykłej strony internetowej. Czy to oznacza, że nadszedł czas, żeby zostać Frontend Tech Writerem?
Rozmawiamy o tym jakie umiejętności z zakresu technologii webowych mogą się przydać w pracy technoskryby, w jaki sposób je zdobywać i do czego można je wykorzystać w procesie tworzenia dokumentacji.
Dźwięki wykorzystane w audycji pochodzą z kolekcji "107 Free Retro Game Sounds" dostępnej na stronie https://dominik-braun.net, udostępnianej na podstawie licencji Creative Commons license CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
Informacje dodatkowe:
- "Co to jest Front-end i kim jest frontend developer?", Software Development Academy: https://sdacademy.pl/frontend-co-to-jest/
- HTML: https://pl.wikipedia.org/wiki/HTML
- CSS: https://pl.wikipedia.org/wiki/Kaskadowe_arkusze_styl%C3%B3w
- WordPress: https://wordpress.com/
- JavaScript: https://pl.wikipedia.org/wiki/JavaScript
- "#47 Tech Writer zgłębia tajniki dostępności cyfrowej, czyli jak tworzyć dokumentację dla wszystkich", Tech Writer koduje: https://techwriterkoduje.pl/blog/2022/10/13/dostepnosc-cyfrowa
- "#25 Tech Writer koduje w dokumentacji, czyli Markdown w wersji rozszerzonej", Tech Writer koduje: https://techwriterkoduje.pl/blog/2021/01/21/tech-writer-koduje-w-dokumentacji
- Markdown: https://daringfireball.net/projects/markdown/syntax
- MDX: https://mdxjs.com/
- "Wprowadzenie do JSX": https://pl.reactjs.org/docs/introducing-jsx.html
- React: https://pl.reactjs.org/
- "What is a Static Site Generator? And 3 ways to find the best one": https://www.netlify.com/blog/2020/04/14/what-is-a-static-site-generator-and-3-ways-to-find-the-best-one/
- Docusaurus: https://docusaurus.io/
- Jamstack: https://jamstack.org/
- EJS: https://ejs.co/
- Eleventy (11ty): https://www.11ty.dev/
- TypeScript: https://www.typescriptlang.org/
- Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
- MadCap Flare: https://www.madcapsoftware.com/products/flare/
- Git: https://git-scm.com/