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:

#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.

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/

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/

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/

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/

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

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/  

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/

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/

#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

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

Wyszukiwanie

Kategorie