Antora as an intranet platform

Antora is a fairly new open source static site generator, aimed at Technical Authors who prefer writing in AsciiDoc than Markdown. SitePoint describes a static site generator as: A compromise between using a hand-coded static site and a full CMS (such as WordPress or Confluence). You generate an HTML-only website using raw data (such as… Read more »

Podcast 65: Making ReadMe files more engaging, with Shwetha Madhan of VMWare

Shwetha Madhan works as an Information Developer for VMware, in Atlanta Georgia. She recently worked on a new approach to the release notes for the Workspace ONE product, where VMWare effectively turned them into a powerful marketing tool. They achieved a 7-fold increase in their click through rates (CTRs) by implementing a new tone of voice and engagement… Read more »

Vacancy: #4192 Contract API Technical Author, Central London, 4 months

Revised description: Our client is looking for a Technical Author to help them create a developer portal that will  support the organisations that use their APIs and SDKs. You will help them develop the documentation: API reference documentation Ideally, the SDK documentation The SDKs are used by their partners to build mobile apps written in… Read more »

How you could make your Help topics appear at the top of the Search Engines

  We’ve just uploaded a video on “How you could make your Help topics appear at the top of the Search Engines”. It’s about Schema.org/HowTo, which Google is promoting as the way to get instructional content to appear in the snippets box. There is a longer version of this video in Cherryleaf’s Advanced Technical Writing… Read more »

Vacancy: #4192 Technical Author / UX Content Writer, London, circa £35K

Our client is looking for a Technical Author/UX Content writer to work as part of its User Experience team. The Technical Authors in this team focus on improving the customer journey. To achieve this, they develop contextual Help, web-based Help pages, API guides, and a few PDF documents. Your role will be to work on… Read more »