Skip to main content
Tech Writer koduje

Tech Writer koduje

By Doc Developer
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.
Listen on
Where to listen
Apple Podcasts Logo

Apple Podcasts

Breaker Logo

Breaker

Google Podcasts Logo

Google Podcasts

Overcast Logo

Overcast

Pocket Casts Logo

Pocket Casts

RadioPublic Logo

RadioPublic

Spotify Logo

Spotify

Currently playing episode

#3 SVG - przenieś grafikę w dokumentacji na wyższy poziom

Tech Writer koduje

1x
#21 Tech Writer zbiera informacje ze stron, czyli jak można wykorzystać web scraping
Web scraping to zbieranie danych ze stron internetowych. Google, na przykład, robi to, żeby indeksować cały internet w swojej wyszukiwarce. Web scraping wykorzystuje się też do monitorowania cen w konkurencyjnych sklepach internetowych. U nas w firmie używamy web scrapingu, żeby indeksować dokumentację dla naszej wyszukiwarki. To samo rozwiązanie wykorzystujemy też, żeby sprawdzać czy wszystkie linki działają. Wyniki web scrapingu zapisujemy  w Elasticsearchu, a potem analizujemy je za pomocą raportów i filtrów  w Kibanie. Dzięki temu stworzyliśmy zalążek panelu kontrolnego, na którym widać aktualną jakość naszej dokumentacji. W niedalekiej przyszłości chcemy  rozszerzyć nasze rozwiązanie o dodatkowe funkcje. Planujemy, na przykład, testować strony pod kątem wymaganych elementów i zgodności z regułami  naszego style guide’a. Kolejną opcją jest sprawdzanie czy w treści nie ma błędów gramatycznych i stylistycznych oraz czy język, którego używamy do tworzenia instrukcji jest wystarczająco przejrzysty. Co można jeszcze zrobić za pomocą web scrapingu? Jakie inne testy są potrzebne w świecie dokumentacji technicznej i pisania ustrukturyzowanego? Zapraszamy do słuchania. Informacje dodatkowe: Web scraping: https://en.wikipedia.org/wiki/Web_scraping Scrapy: https://scrapy.org/ Elastic (Elasticsearch, Kibana): https://www.elastic.co/ curl: https://curl.haxx.se/ Textstat: https://github.com/shivam5992/textstat spaCy: https://spacy.io/ Selenium: https://www.selenium.dev/ TestCafe: https://devexpress.github.io/testcafe/ Vale: https://github.com/errata-ai/vale
32:54
September 15, 2020
#20 Tech Writer optymalizuje, czyli web performance w dokumentacji
Wydajność to temat rzadko poruszany w tech writingu, pomimo tego, że webowa forma dokumentacji jest bardzo popularna. Czy szybkość ładowania stron ma znaczenie dla naszych odbiorców? A jeśli tak, to czy Tech Writer ma jakiś wpływ na wydajność dokumentacji? Rozmawiamy o tym jak mierzyć i poprawiać web performance. Zastanawiamy się co może zrobić w tej kwestii Tech Writer, a co musi wdrożyć programista lub inżynier DevOps. Wreszcie rozmawiamy o tym, że w dokumentacji performance to nie wszystko. Informacje dodatkowe: Web performance: https://en.wikipedia.org/wiki/Web_performance "How to Improve Your Page Load Speed by 70.39% in 45 Minutes": https://www.ventureharbour.com/improving-site-speed/ TinyPNG: https://tinypng.com/ ImageMagick: https://imagemagick.org/index.php Gzip: https://www.gnu.org/software/gzip/ Chunking w standardzie DITA: https://docs.oasis-open.org/dita/v1.2/os/spec/archSpec/chunking.html Minifikacja: https://pl.wikipedia.org/wiki/Minifikacja HTTP caching: https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching WordPress: https://wordpress.com "What Are Static Site Generators?": https://www.netguru.com/blog/what-are-static-site-generators Google PageSpeed Insights: https://developers.google.com/speed/pagespeed/insights/ Google Lighthouse: https://developers.google.com/web/tools/lighthouse Docusaurus: https://docusaurus.io/
37:07
August 6, 2020
#19 Tech Writer pracuje zdalnie, czyli jak to się robi w GitLabie
Trwająca od kilku miesięcy sytuacja spowodowała, że biura zostały pozamykane a praca zdalna z dnia na dzień stała się nowym standardem. Jednak istnieją też takie firmy, które już na wczesnym etapie rozwoju podjęły świadomą decyzję, że postawią na model pracy bez tradycyjnych biur. O byciu w pełni zdalnym Technical Writerem rozmawiamy z Marcinem Sędłakiem-Jakubowskim z firmy GitLab. Pytamy o procesy, narzędzia, budowanie relacji i staramy się ustalić czy jest w tym wszystkim jakiś haczyk. Informacje dodatkowe: About GitLab: https://about.gitlab.com GitLab Handbook: https://about.gitlab.com/handbook/ GitLab Unfiltered: https://www.youtube.com/channel/UCMtZ0sc1HHNtGGWZFDRTh5A  All-Remote Meetings: https://about.gitlab.com/company/culture/all-remote/meetings/ Creating GitLab’s remote playbook: https://changelog.com/podcast/397 Visual Studio Code: https://code.visualstudio.com/ Manjaro Linux: https://manjaro.org/ Vale: https://errata-ai.github.io/vale/ Vim: https://www.vim.org/ Nanoc: https://nanoc.ws/
53:46
July 8, 2020
#18 Wyboista droga do kodowania
Przejście od zera do kodującego Tech Writera to dość długa droga, i nie zawsze usłana różami. Jednak przy odpowiedniej motywacji i podejściu można podołać temu wyzwaniu. Rozmawiamy o tym jak zacząć naukę kodowania, przez jakie etapy trzeba przejść i jak radzić sobie z problemami i pułapkami. Informacje dodatkowe: Why Learning To Code Is So Damn Hard: https://www.thinkful.com/blog/why-learning-to-code-is-so-damn-hard/ Skillshare: https://www.skillshare.com/ Codecademy: https://codecademy.dev/ Stack Overflow: https://stackoverflow.com/
48:11
June 9, 2020
#17 Webhelp kontra Progressive Web App
Offline help, który sam się aktualizuje. Czy to w ogóle możliwe? Zastanawiamy się czy webhelp czasy świetności ma już za sobą  i czy Progressive Web App (PWA) ma szansę zostać nowym królem helpów. Informacje dodatkowe: HTML Help: https://pl.wikipedia.org/wiki/HTML_Help "About Webhelp Output" (pomoc MadCap Flare 2017r3): https://help.madcapsoftware.com/flare2017r2/Content/Output/Flare/WebHelp-Output/About-WebHelp-Output.htm Progressive Web Application: https://en.wikipedia.org/wiki/Progressive_web_application "Co zmieniają Progressive Web Applications? Wszystko, co musisz wiedzieć o PWA": https://www.e-point.pl/blog/co-zmieniaja-progressive-web-applications-wszystko-co-musisz-wiedziec-o-pwa Oxygen Webhelp: https://www.oxygenxml.com/xml_editor/webhelp.html
30:40
May 18, 2020
16# DITA z Gita
Czy szanujący się zespół dokumentacyjny używający standardu DITA może działać bez CCMSa? Czy Technical Writer odnajdzie się w gicie? Jakie wyzwania stwarza taka implementacja? Techniczna rozmowa o technical writingu. Informacje dodatkowe: Standard DITA (Darwin Information Typing Architecture): https://en.wikipedia.org/wiki/Darwin_Information_Typing_Architecture Component Content Management System (CCMS): https://en.m.wikipedia.org/wiki/Component_content_management_system DITA Open Toolkit: https://www.dita-ot.org/ Git: https://git-scm.com/ DITA for Small Teams: http://www.d4st.org/ Python: https://www.python.org/ IntelliJ IDEA: https://www.jetbrains.com/idea/ Poetry: https://python-poetry.org/ Gradle: https://gradle.org/ Lightweight DITA: http://docs.oasis-open.org/dita/LwDITA/v1.0/cn01/LwDITA-v1.0-cn01.pdf Oxygen XML: https://www.oxygenxml.com/ Schematron: http://schematron.com/ Apache Ant: https://ant.apache.org/ Extensible Stylesheet Language Transformations (XSLT): https://pl.wikipedia.org/wiki/XSL_Transformations Pytest: https://docs.pytest.org/en/latest/ Git submodules: https://git-scm.com/book/en/v2/Git-Tools-Submodules Continuous integration (CI): https://en.m.wikipedia.org/wiki/Continuous_integration TeamCity: https://www.jetbrains.com/teamcity/ npm: https://www.npmjs.com/ Docker: https://www.docker.com/ Bitbucket: https://bitbucket.org/ Progressive Web Apps: https://web.dev/what-are-pwas/ Prince XML: https://www.princexml.com/
33:15
April 22, 2020
#15 Technoskryby potyczki z SME, czyli jak zdobywać informacje potrzebne do tworzenia dokumentacji
Jak Technical Writer radzi sobie ze zdobywaniem informacji? Co jeśli Subject Matter Expert (SME) jest niedostępny? A co jeśli dwóch SME nie może się zgodzić co jest najważniejsze? Rozmawiamy z Mateuszem Boryckim, który przynosi cztery prawdziwe historie (case studies) z życia Technical Writera.
1:06:10
April 7, 2020
#14 Tech Writer zaczyna kodować w Pythonie, czyli o narzędziach i dobrych praktykach
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://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/
50:07
March 24, 2020
#13 Full-Stack Tech Writer, czyli technoskryba kontra chmura
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/
45:17
February 25, 2020
#12 Tech Writer się rekrutuje, czyli jak ważne 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.
54:22
January 20, 2020
#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