RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
This talk was presented at API The Docs Virtual 2020 event series on 4 November. We are honored to share the video recording, slide deck, and talk summary below. Enjoy!
Visit the API The Docs 2020 recaps overview to explore all presentations from 2020. API the Docs Virtual begins May 2021! CFP closes February 28, 2021.
Project Manager - Doc Ops at Adyen
In 2017 first conversation about moving to docs-as-code/DocOps. Issues were that for almost every solution they had to use plugins, the fronted tech was unfriendly, the possible tools didn’t eradicate collaboration barriers, and most of them used unconventional documentation formats.
Now, at Adyen, the documentation team is managing 2000+ pages of documentation, having 1000 reused items for different audiences in a collaborative, central, crowd-sourced docs-as-code environment based on Markdown and Github. They are working closely with the CMS developers to have a convenient and useful IDE (integrated development environment) and they write their own extensions and tools to test and publish their docs.
DocOps involves facilitating a content flow that is collaborative, agile, continuous, enables reuse; it helped create a culture that serves documentation in a way that understands how techwriters work.
Their DocOps tools are about to keep the docs flowing.
Technical writers are frustrated by having to update:
Watch the video recording for a live demo.
RT @DeliberateComp1: "How cognitive biases and ranking can foster an ineffective architecture and design" Don't miss out on… https://t.co/Njau4ATXn0
RT @DeliberateComp1: "APIs: Semi-permeable, osmotic interfaces" Don't miss out on @dawnahukanna's talk next week at the… https://t.co/rF2qm9E2WM
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/5ZkCEKHS7S
Deliberate Complexity 2022 features a series of three events organized by @pronovix with the intent to create a spa… https://t.co/uFiX820fCE
Big thanks to @palantir and @pronovix for sponsoring the #drupal update project bot. This tool is a major reason… https://t.co/OVYevQEFLG