Tech Writer koduje
Podcast o technicznej stronie tworzenia dokumentacji w IT. Skupiamy się na tym jak Tech Writer może wpasować się w środowisko programistów zarówno pod kątem sposobu pracy jak i używanych technologii, narzędzi i rozwiązań. Staramy się też pokazać, że praca Tech Writera może być ciekawa i rozwijająca pod kątem umiejętności technicznych.
Kategorie:
Technologia
Technologia
#4 Konferencja soap! 2019 - podsumowanie
2019-07-07 23:11:12
soap! to jedyna polska konferencja dla specjalistów zajmujących się szeroko pojętą treścią. Motywem przewodnim tegorocznej edycji było "Content as code". W tym odcinku, dzielimy się swoimi ogólnymi wrażeniami na temat konferencji oraz rozmawiamy o prezentacjach, które najbardziej zapadły w nam pamięć.
Informacje dodatkowe:
Konferencja soap!: http://soapconf.com/
Grupa "#soapconf & #meetcontent community" na Facebooku: https://www.facebook.com/groups/372572899591391/
Projekt Kyma: https://kyma-project.io/
soap! to jedyna polska konferencja dla specjalistów zajmujących się szeroko pojętą treścią. Motywem przewodnim tegorocznej edycji było "Content as code". W tym odcinku, dzielimy się swoimi ogólnymi wrażeniami na temat konferencji oraz rozmawiamy o prezentacjach, które najbardziej zapadły w nam pamięć.
Informacje dodatkowe:
Konferencja soap!: http://soapconf.com/
Grupa "#soapconf & #meetcontent community" na Facebooku: https://www.facebook.com/groups/372572899591391/
Projekt Kyma: https://kyma-project.io/
#3 SVG - przenieś grafikę w dokumentacji na wyższy poziom
2019-06-14 22:31:16
Scalable Vector Graphics (SVG) kryje w sobie wiele ciekawych aspektów, które Technical Writerzy mogliby potencjalnie wykorzystać. Nasz gość, Daniel Barrio Fierro, od jakiegoś czasu nie tylko pasjonuje się tym formatem, ale również wykorzystuje jego zalety pracując nad dokumentacją. W tym odcinku rozmawiamy z Danielem o tym jak Technical Writerzy mogą zmienić podejście do elementów graficznych w dokumentacji i utrzymywać je sprytniej wykorzystując format SVG.
Informacje dodatkowe:
CodePen: https://codepen.io/
Inkscape: https://inkscape.org/
Dokumentacja MDN na temat SVG: https://developer.mozilla.org/pl/docs/Web/SVG
Dokumentacja W3C na temat SVG 1.1.: https://www.w3.org/TR/SVG11/
Daniel Barrio Fierro (profil LinkedIn): https://www.linkedin.com/in/daniel-barrio-fierro-a95053110/
Daniel Barrio Fierro (strona na GitHub): http://db4rr.github.io
Scalable Vector Graphics (SVG) kryje w sobie wiele ciekawych aspektów, które Technical Writerzy mogliby potencjalnie wykorzystać. Nasz gość, Daniel Barrio Fierro, od jakiegoś czasu nie tylko pasjonuje się tym formatem, ale również wykorzystuje jego zalety pracując nad dokumentacją. W tym odcinku rozmawiamy z Danielem o tym jak Technical Writerzy mogą zmienić podejście do elementów graficznych w dokumentacji i utrzymywać je sprytniej wykorzystując format SVG.
Informacje dodatkowe:
CodePen: https://codepen.io/
Inkscape: https://inkscape.org/
Dokumentacja MDN na temat SVG: https://developer.mozilla.org/pl/docs/Web/SVG
Dokumentacja W3C na temat SVG 1.1.: https://www.w3.org/TR/SVG11/
Daniel Barrio Fierro (profil LinkedIn): https://www.linkedin.com/in/daniel-barrio-fierro-a95053110/
Daniel Barrio Fierro (strona na GitHub): http://db4rr.github.io
#2 Python - przyjaciel Tech Writera
2019-05-23 08:39:34
Python to język programowania ogólnego zastosowania, który w ostatnich latach zyskuje coraz większą popularność nie tylko wśród programistów. Jednym z powodów jest niewątpliwie jego przystępna składnia przez co osoby, które nie są bardzo techniczne są w stanie dość szybko opanować podstawy kodowania w tym języku. Dlatego też Python wydaje się być dobrą propozycją dla Technical Writerów, którzy chcą tworzyć narzędzia wspomagające proces tworzenia treści.
Informacje dodatkowe:
Codecademy, kurs Pythona: https://www.codecademy.com/learn/learn-python (niestety, za darmo dostępny jest tylko kurs dla Pythona 2)
"The Hitchhiker’s Guide to Python!", Kenneth Reitz, Tanya Schlusser: https://docs.python-guide.org/
Real Python: https://realpython.com/
"Python Tricks: The Book", Dan Bader: https://realpython.com/products/python-tricks-book/
Python Bytes Podcast: https://pythonbytes.fm/
Talk Python to Me Podcast: https://talkpython.fm/
Test & Code Podcast: https://testandcode.com /
The Python Standard Library: https://docs.python.org/3/library/
PEP 8 - Style Guide for Python Code: https://www.python.org/dev/peps/pep-0008/
PEP 20 - The Zen of Python: https://www.python.org/dev/peps/pep-0020/
Biblioteka pyjokes: https://github.com/pyjokes/pyjokes
Zegar odliczający czas do zakończenia wsparcia Pythona 2: https://pythonclock.org/
Visual Studio Code: https://code.visualstudio.com
IntelliJ IDEA: https://www.jetbrains.com/idea/
PyCharm: https://www.jetbrains.com/pycharm/
Python to język programowania ogólnego zastosowania, który w ostatnich latach zyskuje coraz większą popularność nie tylko wśród programistów. Jednym z powodów jest niewątpliwie jego przystępna składnia przez co osoby, które nie są bardzo techniczne są w stanie dość szybko opanować podstawy kodowania w tym języku. Dlatego też Python wydaje się być dobrą propozycją dla Technical Writerów, którzy chcą tworzyć narzędzia wspomagające proces tworzenia treści.
Informacje dodatkowe:
Codecademy, kurs Pythona: https://www.codecademy.com/learn/learn-python (niestety, za darmo dostępny jest tylko kurs dla Pythona 2)
"The Hitchhiker’s Guide to Python!", Kenneth Reitz, Tanya Schlusser: https://docs.python-guide.org/
Real Python: https://realpython.com/
"Python Tricks: The Book", Dan Bader: https://realpython.com/products/python-tricks-book/
Python Bytes Podcast: https://pythonbytes.fm/
Talk Python to Me Podcast: https://talkpython.fm/
Test & Code Podcast: https://testandcode.com/
The Python Standard Library: https://docs.python.org/3/library/
PEP 8 - Style Guide for Python Code: https://www.python.org/dev/peps/pep-0008/
PEP 20 - The Zen of Python: https://www.python.org/dev/peps/pep-0020/
Biblioteka pyjokes: https://github.com/pyjokes/pyjokes
Zegar odliczający czas do zakończenia wsparcia Pythona 2: https://pythonclock.org/
Visual Studio Code: https://code.visualstudio.com
IntelliJ IDEA: https://www.jetbrains.com/idea/
PyCharm: https://www.jetbrains.com/pycharm/
#1 Docs like code - rozważania praktyczne i filozoficzne
2019-05-14 22:22:19
"Docs like code" czy "Docs as code" to model tworzenia dokumentacji, który staje się coraz bardziej popularny wśród Tech Writerów w IT. Głównym założeniem jest traktowanie dokumentacji jak kodu pod kątem procesów oraz narzędzi, których używamy do jej tworzenia. Ale czy to wszystko? Staramy się przyjrzeć dokładniej temu trendowi, żeby odkryć co jeszcze może się za nim kryć.
Informacje dodatkowe:
"Docs like code", Anne Gentle: https://www.docslikecode.com/book/
Konferencja soap!: http://soapconf.com/
"Docs as code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/
"Docs like code" czy "Docs as code" to model tworzenia dokumentacji, który staje się coraz bardziej popularny wśród Tech Writerów w IT. Głównym założeniem jest traktowanie dokumentacji jak kodu pod kątem procesów oraz narzędzi, których używamy do jej tworzenia. Ale czy to wszystko? Staramy się przyjrzeć dokładniej temu trendowi, żeby odkryć co jeszcze może się za nim kryć.
Informacje dodatkowe:
"Docs like code", Anne Gentle: https://www.docslikecode.com/book/
Konferencja soap!: http://soapconf.com/
"Docs as code", Write the Docs: https://www.writethedocs.org/guide/docs-as-code/