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.
Technologia
#14 Tech Writer zaczyna kodować w Pythonie, czyli o narzędziach i dobrych praktykach
2020-03-24 13:57:11
Rozmawiamy z Sebastianem Witowskim o tym jak ustawić sobie środowisko do kodowania w Pythonie i jakich błędów unikać zaczynając swoją przygodę z tym językiem programowania. Spora dawka wiedzy dla początkujących Pythonistów. Ale jeśli kodujesz w Pythonie od jakiegoś czasu i chcesz się upewnić, że stosujesz dobre praktyki, to ten odcinek jest też dla Ciebie.
Informacje dodatkowe:
Python: https://www.python.org/
Intellij IDEA: https://www.jetbrains.com/idea/
PyCharm: https://www.jetbrains.com/pycharm/
Visual Studio Code (VS Code): https://code.visualstudio.com/
Vim: https://www.vim.org/
pyenv: https://github.com/pyenv/pyenv
Python venv: https://docs.python.org/3/library/venv.html
Python virtualenv: https://virtualenv.pypa.io/en/stable/
Conda: https://docs.conda.io/en/latest/
Node modules: https://www.w3schools.com/nodejs/nodejs_modules.asp
Pipenv: https://pipenv.readthedocs.io/en/latest/
Poetry: https://python-poetry.org/
Python Requests: https://2.python-requests.org/en/master/
Django: https://www.djangoproject.com/
Flask: https://flask.palletsprojects.com/en/1.1.x/
EuroPython 2019: https://ep2019.europython.eu/
Cookiecutter: https://cookiecutter.readthedocs.io/en/1.7.0/
Pipx: https://github.com/pipxproject/pipx
Black: https://github.com/psf/black
npx: https://www.npmjs.com/package/npx
"The Hitchhiker’s Guide to Python!", Kenneth Reitz, Tanya Schlusser: https://docs.python-guide.org/
Sphinx: http://www.sphinx-doc.org/en/master/
Write the Docs: https://www.writethedocs.org/
Pytest: https://docs.pytest.org/en/latest/
Python unittest: https://docs.python.org/3.8/library/unittest.html
Test Driven Development (TDD): https://www.agilealliance.org/glossary/tdd/
Git: https://git-scm.com/
Warsztat "Modern Python Developer's Toolkit": https://www.meetup.com/Pykonik/events/268809734/
Pykonik, Kraków Python User Group: https://www.meetup.com/Pykonik/
Profil Sebastiana na LinkedIn: https://www.linkedin.com/in/switowski/
Profil Sebastiana na Twitterze: https://twitter.com/SebaWitowski
Strona Sebastiana: https://switowski.com/
#13 Full-Stack Tech Writer, czyli technoskryba kontra chmura
2020-02-25 14:25:48
Jakie są obowiązki Technical Writera? Pewnie większość z Was odpowiedziałaby, że pisanie dokumentacji. A co z budowaniem stron i hostowaniem ich w chmurze? Damy sobie z tym radę? Ten odcinek to nie rozważania teoretyczne, ale oparta na faktach historia o tym jak trzech Technical Writerów ogarnęło cały stack technologiczny i devops dla portalu z dokumentacją.
Informacje dodatkowe:
Konferencja soap!: http://soapconf.com/
Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
Markdown: https://daringfireball.net/projects/markdown/
DITA Open Toolkit: https://www.dita-ot.org/
Component content management system (CCMS): https://en.wikipedia.org/wiki/Component_content_management_system
Node.js: https://nodejs.org/en/
Python: https://www.python.org/
Scrapy: https://scrapy.org/
Jinja2: https://jinja.palletsprojects.com/en/2.11.x/
Sphinx: http://www.sphinx-doc.org/en/master/
Elasticsearch: https://www.elastic.co/
Kubernetes: https://kubernetes.io/
#12 Tech Writer się rekrutuje, czyli jak ważne są umiejętności techniczne
2020-01-20 16:48:13
Czy ogłoszenie o pracę mówi Ci co będziesz robił jako Technical Writer? Jak pracodawca sprawdzi Twoje umiejętności? Co się liczy u Technical Writera? Rozmawiamy z Tomkiem Prusem o blaskach i cieniach rekrutowania Technical Writerów starając się odpowiedzieć na pytanie jak ważne w naszej profesji są umiejętności techniczne.
#11 Robot dokumentuje część 2 - automatyzacja kontra ludzie
2019-12-12 20:02:21
Spotkaliśmy się z Agatą Rygielską i rozmawialiśmy o wpływie automatyzacji na ludzi i ich pracę. Agata jest Technical Writerką od 2 lat, a wcześniej pracowała w branży tłumaczeniowej. Widziała jak automatyzacja doprowadziła do marginalizacji "białkowych" tłumaczy. Jej doświadczenia doprowadziły nas do rozważań o przyszłości komunikacji technicznej. Czy przyszłość rysuje się optymistycznie dla Technical Writerów, czy raczej w ciemnych barwach?
Informacje dodatkowe:
DeepL: https://www.deepl.com/translator
MadCap Software: https://www.madcapsoftware.com/
Konferencja Tłumaczy: https://www.konferencjatlumaczy.pl/
#10 Docusaurus - Tech Writer dokarmia dinozaury
2019-11-15 12:45:30
Docusaurus to static site generator stworzony przez Facebooka, którego główną zaletą jest prostota. Rozmawiamy o tym co oferuje to narzędzie, jakie są jego mocne i słabe strony oraz w jakich sytuacjach może się sprawdzić jako rozwiązanie do tworzenia dokumentacji.
Informacje dodatkowe:
Docusaurus: https://docusaurus.io/
Using Docusaurus to Create Open Source Websites: https://www.youtube.com/watch?v=QcGJsf6mgZE
React: https://pl.reactjs.org/
Crowdin: https://crowdin.com/
StaticGen: https://www.staticgen.com/
I'd Rather Be Writing: https://idratherbewriting.com/
Tech Writer koduje: https://techwriterkoduje.pl/
#9 Robot dokumentuje, czyli technical writing przyszłości
2019-10-17 18:34:12
Podobno nikt nie jest niezastąpiony, ale czy można zastąpić całą grupę zawodową? Zwłaszcza ludzi, którzy robią research, rozmawiają z innymi i piszą? O automatyzacji w technical writingu rozmawia z nami Wojtek Aleksander.
Informacje dodatkowe:
"The Future of Employment: How susceptible are jobs to computerisation?", Oxford Martin: https://www.oxfordmartin.ox.ac.uk/publications/the-future-of-employment/
"10 skills you'll need to survive the rise of automation", World Economic Forum: https://www.weforum.org/agenda/2018/07/the-skills-needed-to-survive-the-robot-invasion-of-the-workplace
"JPMorgan Chase inks 5-year deal to generate marketing copy via AI", Marketing Dive: https://www.marketingdive.com/news/jpmorgan-chase-inks-5-year-deal-to-generate-marketing-copy-via-ai/559836/
Horse ebooks (Twitter bot): https://twitter.com/horse_ebooks
Bot or not: http://botpoet.com/
"Can science writing be automated?", MIT News: http://news.mit.edu/2019/can-science-writing-be-automated-ai-0418
"Lithium-Ion Batteries. A Machine-Generated Summary of Current Research", Springer: https://link.springer.com/book/10.1007/978-3-030-16800-1
"The Rise of the Robot Reporter", New York Times: https://www.nytimes.com/2019/02/05/business/media/artificial-intelligence-journalism-robots.html
Konferencja Tłumaczy: https://www.konferencjatlumaczy.pl/
Wojtek Aleksander (profil LinkedIn): https://www.linkedin.com/in/waleksander/
#8 DITA OT - static site generator dla wtajemniczonych
2019-09-28 22:16:10
Jako technoskrybi, którzy kodują, spędziliśmy trochę czasu z DITA Open Toolkit. Rozmawiamy o tym do czego służy DITA OT i jakie ma możliwości. Mówimy o wadach i zaletach. Podpowiadamy też jak zacząć pracę z tym narzędziem. Pracujesz z ditą lub chcesz dowiedzieć się o niej więcej? To jest odcinek dla Ciebie.
Informacje dodatkowe:
Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture
Konsorcjum OASIS: https://www.oasis-open.org/
DITA Open Toolkit: https://www.dita-ot.org/
Lightweight DITA: http://docs.oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.pdf
Extensible Stylesheet Language Transformations (XSLT): https://pl.wikipedia.org/wiki/XSL_Transformations
XSL Formatting Objects (FO): https://pl.wikipedia.org/wiki/XSL_Formatting_Objects
Syncro Soft: http://www.sync.ro/
Oxygen XML: https://www.oxygenxml.com/
Oxygen Webhelp: https://www.oxygenxml.com/xml_editor/webhelp.html
easyDITA: https://easydita.com/
Schematron: http://schematron.com/
Apache Ant: https://ant.apache.org/
Wtyczka Gradle dla DITA OT: https://eerohele.github.io/dita-ot-gradle/
Adobe Experience Manager: https://www.adobe.com/pl/marketing/experience-manager.html
Markdown: https://daringfireball.net/projects/markdown/syntax
reStructuredText: http://docutils.sourceforge.net/rst.html
AsciiDoc: http://asciidoc.org/
Sphinx: http://www.sphinx-doc.org/en/master/
StaticGen: https://www.staticgen.com/
#7 Programista dokumentuje, czyli nowoczesny technical writing
2019-08-29 21:23:13
W nowoczesnej firmie software’owej nie ma ani jednego Technical Writera. W takim razie czym się zajmuje nasz gość, Rafał Pawlicki, który pracuje jako Documentation Manager? Dynamiczne zmiany w świecie technologii powodują, że coraz częściej w firmach wytwarzających oprogramowanie granice między tradycyjnie zdefiniowanymi rolami zaczynają się zacierać. Nierzadko Tech Writer koduje, a programista dokumentuje. Rozmawiamy o przyszłości Technical Writerów, o tym jak stać się elastycznym specjalistą od treśći i nie zamykać się w silosie oraz mierzymy się ze stereotypami związanymi z podejściem programistów do dokumentacji i z ich postrzeganiem roli Tech Writera. Posłuchajcie!
Informacje dodatkowe:
Atlassian Confluence: https://www.atlassian.com/pl/software/confluence
Sphinx: http://www.sphinx-doc.org/en/master/
Markdown: https://daringfireball.net/projects/markdown/syntax
reStructuredText: https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html
PyCharm: https://www.jetbrains.com/pycharm/
IntelliJ IDEA: https://www.jetbrains.com/idea/
Rafał Pawlicki (profil LinkedIn): https://pl.linkedin.com/in/rafa%C5%82-pawlicki-973281165
#6 Konferencja EuroPython 2019 z perspektywy kodującego Tech Writera
2019-08-12 15:34:29
EuroPython to największa europejska konferencja poświęcona językowi programowania Python. Tegoroczna edycja odbyła się w dniach 8-14 lipca w Bazylei (Szwajcaria). Przyglądamy się temu wydarzeniu z perspektywy Technical Writera, który od jakiegoś czasu korzysta z Pythona w swojej pracy, ale nie jest zawodowym programistą. Rozmawiamy o tym co się działo podczas EuroPython 2019 i czego można było się tam nauczyć.
Informacje dodatkowe:
Konferencja EuroPython 2019: https://ep2019.europython.eu/
Nagrania wystąpień z EuroPython 2019: https://www.youtube.com/user/PythonItalia
Budowanie mechanizmu rekomendacji w Pythonie: https://realpython.com/build-recommendation-engine-collaborative-filtering/
Dekoratory w Pythonie: https://realpython.com/primer-on-python-decorators/
Narzędzie poetry: https://poetry.eustace.io/
"Modern Python Standard Library Cookbook", Alessandro Molina: https://www.amazon.com/Modern-Python-Standard-Library-Cookbook/dp/1788830822
Baza danych MongoDB: https://www.mongodb.com/
Konferencja PyCon PL 2019: https://pl.pycon.org/2019/
#5 Narzędzia dla Tech Writerów
2019-07-24 08:38:11
Mogłoby się wydawać, że Tech Writerzy nie mają dużych potrzeb jeśli chodzi o narzędzia. W końcu co może być potrzebne do napisania instrukcji? Zapewne wystarczy jakiś prosty edytor i tyle. Nic bardziej mylnego. Technical Writerzy, jak każda profesja, również mają swoje rozwiązania, które pozwalają im tworzyć, dostarczać i łatwiej utrzymywać profesjonalną dokumentację. W dzisiejszym odcinku przyglądamy się temu z jakich narzędzi mogą skorzystać osoby zajmujące się tworzeniem treści, podsumowujemy ich mocne i słabe strony i staramy się ustalić w jakich sytuacjach najlepiej się sprawdzają.
Informacje dodatkowe:
Quark XML Author for Microsoft Word: http://www.quark.com/Products/Quark_XML_Author/
Schema ST4: https://www.schema.de/en/
MadCap Flare: https://www.madcapsoftware.com/products/flare/
Help and Manual: https://www.helpandmanual.com/
Adobe RoboHelp: https://www.adobe.com/pl/products/robohelp.html
OpenAPI: https://www.openapis.org/
Swagger UI: https://swagger.io/tools/swagger-ui/
ReadMe.io: https://readme.com/
DapperDox: http://dapperdox.io/
easyDITA: https://easydita.com/
Snagit: https://www.techsmith.com/screen-capture.html
draw.io: https://www.draw.io/
Inkscape: https://inkscape.org/
GIMP: https://www.gimp.org/
DaVinci Resolve: https://www.blackmagicdesign.com/products/davinciresolve/
Visual Studio Code: https://code.visualstudio.com/
The Jupyter Notebook: https://jupyter.org/
Storybook: https://storybook.js.org/
DocToolHub: https://doctoolhub.com/
StaticGen: https://www.staticgen.com/