Tech Writer koduje

#10 Docusaurus - Tech Writer dokarmia dinozaury

An episode of Tech Writer koduje

By Doc Developer
About
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.
More places to listen
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.
techwriterkoduje.pl

More places to listen

#11 Robot dokumentuje część 2 - automatyzacja kontra ludzie
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/
51:13
December 12, 2019
#10 Docusaurus - Tech Writer dokarmia dinozaury
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/
51:04
November 15, 2019
#9 Robot dokumentuje, czyli technical writing przyszłości
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/
59:02
October 17, 2019
#8 DITA OT - static site generator dla wtajemniczonych
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/
52:05
September 28, 2019
#7 Programista dokumentuje, czyli nowoczesny technical writing
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
1:01:38
August 29, 2019
#6 Konferencja EuroPython 2019 z perspektywy kodującego Tech Writera
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/ 
44:42
August 12, 2019
#5 Narzędzia dla Tech Writerów
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/
51:24
July 24, 2019
#4 Konferencja soap! 2019 - podsumowanie
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/
38:12
July 7, 2019
#3 SVG - przenieś grafikę w dokumentacji na wyższy poziom
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
56:46
June 14, 2019
#2 Python - przyjaciel Tech Writera
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/
43:49
May 23, 2019
#1 Docs like code - rozważania praktyczne i filozoficzne
"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/ 
37:08
May 14, 2019
Make your own podcast for free with Anchor!