1. SIGDOC'2021 Lisbon Hub: Interview

    SIGDOC'2021 experimented with a mixed format that combined regular online events, both synchronous and asynchronous, with eight additional presential meetups called "hubs". For the Lisbon Hub, EuroSIGDOC interviewed Robert Pierce, Konstanze Alex, and myelf.

    read more
  2. F-Talk: Integrated API Documentation at Scale

    As part of the Farfetch F-Tech Talks, I reported on the tools and processes used at Farfetch to create and publish API documentation, and how they evolved over time.

    The API documentation combines traditional DITA topics with API references generated automatically through Open API specifications. The generation of API references …

    read more
  3. TCUK'2019: Workshop Inspire with Comics

    I wanted to attend the Technical Communication UK conference for years. The conference offered a reasonably priced residential fee in a countryside hotel. For a foreigner, this means an affordable conference, with more opportunities than usual to network with local colleagues.

    Networking happed over breakfast, lunch, dinner, evenings... and even …

    read more
  4. TCeurope Summer School: Visual Highlights of Features

    During the last TCeurope Summer School, I taught 12 people how they might use comics to communicate the effects of technology in people.

    APCOMTEC (the Portuguese Association for Technical Communication) proposed the Summer School in 2018 as a first step to advance Technical Communication training at ISCAP (a school of …

    read more
  5. TWL: Plain Text with AsciidocFX

    The editor AsciidocFX turns the plain text format Asciidoc into an insightful drafting tool, even if Asciidoc falls short as a production writing tool.

    AsciidocFX customizes the well-known Atom editor to handle AsciiDoc, a plain text format that is much better than Markdown but still weaker than ReStructured Text. AsciiDoc …

    read more
  6. OSDOC’10: The Birth of a Company-Wide Wiki

    A small software company with a worldwide presence uses one wiki to store or access most company information. Using open source software, the wiki started as a small team tool and then grew to reach technical people. An innovative content strategy proposal later extended the reach of the wiki to …

    read more

blogroll

social