APCOMTEC has been promoting a Summer School since 2019. This year, Alexandra Albuquerque had the opportunity to promote the Summer School as an Erasmus+ Blended Intensive Program.
read moreISTC Meets: Stories of Structured Authoring Tools
This presentation started as an unexpected opportunity to present at the ISTC Meets. Usually, the sessions are planned many months in advance.
read moreSIGDOC'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 moreF-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 moreTCUK'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 moreProduct Tank: Inspire with Comics
This talk and demonstration was presented at the Product Tank Lisbon meetup to a group of 36 people, including some technical communicators.
The three-hour workshop that I delivered at the Summer School had been accepted as a 90-minute workshop at the TCUK conference. Even after throwing away the screenplay part …
read moreTCeurope 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 moreTWL: 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 moreTackling the Hard Parts of the Problem
Being effective means that you make time to tackle your hard-to-solve problems, by solving the easy ones very quickly.
read moreAgilePT'2011: Grow your Team with Yearly Meetings
This talk was presented on 22 June 2011 at Agile Portugal 2011, which was held at the Faculty of Engineering of the University of Porto, in Portugal.
Managing a long-term agile team working on continuous improvements to a product creates specific challenges that are not usually felt in project-based approaches …
read moreOrganização 2.0: The Birth of a Company-Wide Wiki
Ana Neves invited me to repeat the OSDOC'10 presentation at her event "Organização 2.0: Ferramentas sociais nas organizações" (Enterprise 2.0: Social tools in enterprises).
I repeated the presentation at ISCTE to an interested and enquiring audience.
References
Ana Neves is a consultant and the owner of Knowman, a …
read moreISCTE: The Birth of a Company-Wide Wiki
Carlos Costa invited me to present my OSDOC'10 paper to his graduate students on open source software at ISCTE. The presentation took place in building ISCTE II, auditorium B203, Saturday, December 18th, at 11h00.
Attendance was open. The expectation is that invited classes at ISCTE might start a local community …
read moreOSDOC’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 moreAgilePT'2010: Agility with Uncertain Tasks
This talk was presented on 26 June 2010 at Agile Portugal 2010, which was held at the Faculty of Engineering of the University of Porto, in Portugal.
Scrum assumes that a 2 to 4 week sprint can be planned in advance, with the work fully divided into 4 to 16 …
read moreSHiFT'2010: The Birth of a Company-Wide Wiki
SHiFT was a grass-roots Portuguese conference about emerging technologies, whether they’re the latest internet trend or the latest social or engineering development.
Since SHiFT had an unconference part, I took the opportunity to test the presentation already prepared for OSDOC'10 on a small audience.
See the presentation at ISCTE …
read more