Suggestions for in-app help/documentation

1
Has anyone implemented in-app documentation or help in their application?  I’m looking for recommendations on strategy.  The simplest solution seems to be to link to a PDF guide.  Has anyone built their help in Mendix?  If so, how did you implement it?  Thanks in advance for the input. 
asked
2 answers
3

Hi Taylor,

The approach I have taken is to host the documentation in Github. This has several advantages over other approaches.

  1. very easy to update
  2. completely free
  3. version control
  4. high ranking on google
  5. searchable

On each page of the mendix application, there is a link to a corresponding document on Github for that particular functionality. 

This link is saved in the database and I set up a special user role that can edit them on the spot. So far it has worked out for me.

The only minor inconvenience is that uploading images and videos can not be done directly with drag-n-drop. Instead, you have to first upload them then link them. Also, from a styling perspective it looks ok but not amazing.

answered
2

Lovely. I talked about this with a colleague today. We use confluence, a well-known documentation tool. But text there gets written and forgotten, hardly ever read. The same goes for most documentation tools is my experience.

Two nice Appstore apps are “Help Text Viewer“ and the “IntroWidget”. The Introwidget is for creating an introduction video. The help text viewer is probably the one most matching your requirement. It is old though, V5 and need to get upgraded first.

answered