I propose that in HR documentation, each process is described via a scenario explained like a tutorial.
To realize the tutorial, and to have more quality, I propose to create a UI Test for each process.
In these tests, some user messages are added and a video recording is in place when it run, so result is usable as a tutorial
With this method to create tutorial we are sure it are up to date and it works !
Currently a tutorial / test exist for process "Organization, Job Position and Definition" and it run ona daily base on Apache OFBiz trunk demo.
A second one exist for process "Employee Salary and Benefits Administration" but for runing some modification /enhancement are needed, so currenlty it not run on Apache OFBiz trunk demo.
Result video are readeable https://video.ploud.fr/video-channels/ofbizextra_tutorial/videos