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

Odcinki od najnowszych:

#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 npm: https://www.npmjs.com/ 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://www.writethedocs.org/ 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/

Informacja dotycząca prawa autorskich: Wszelka prezentowana tu zawartość podkastu jest własnością jego autora

Wyszukiwanie

Kategorie