โญ๏ธ The sites below are inspiring me, that’s why they are in my favorites!

๐Ÿ”ธ I have been doing online documentation (online help) since I started, and in HTML since 2000. It is one of my specialties.

Although Help can still be created by writing HTML in a text editor, nobody does. The helping content should be attractive and responsive, that’s why after using a lot of HATs (Help Authoring Tools) I now use a combination static site generator / Markdown files (among others).

A good Help is action-oriented, structured, maintainable (updates, multi-languages) with smooth navigation and a number of basic topics such as a glossary. Very useful for large online documentation: the search engine.

My favorites are:

  1. Docusaurus v2 ๐Ÿ”—
  2. Hugo ๐Ÿ”—
  3. Jekyll ๐Ÿ”—

This website for example is a combination of Markdown files, Yaml files and a cool Hugo template. Other examples are available in my Portfolio.

๐Ÿ”ธ I used RoboHelp a lot, which allowed online help in HTML with search engine and index as early as 1999.
Adobe RoboHelp ๐Ÿ”— is still a complete solution that allows you to customize your design, manage content and generate searchable immersive help regardless of device or format.
However, RoboHelp creates files in HTML and does not use Markdown.

Concerning DITA, JavaDoc, Doxygen… see my other Favorites pages.