We are resurrecting our OOD installation and I had trouble enabling the app development. Trying to follow https://osc.github.io/ood-documentation/master/app-development/enabling-development-mode.html, I have to admit that I found that document confusing and had to re-read it many times before finally getting it to work. So, I have a few suggestions on that.
Itemize the three steps needed to enable the app development as subsections, and detail what needs to be done and what the options are under each subsection (e.g. for the app paths, either the 1.3 or 1.4 way).
especially for the paths, make another sub-itemization separately for the 1.3 and 1.4 behavior, so one does not confuse the 1.3 behavior with the 1.4.
Then have a separate subsection wrapped around the description of Table 7 = the global enablement of the apps development
it is not clear if one needs to set OOD_DEV_APPS_ROOT (and where this variable goes - presumably in the /etc/ood/config/apps/dashboard/env) AND also modify the nginx_stage.yml appropriately). This needs some clarification too.
it is not clear OOD_DEV_SSH_HOST needs to be set if I set up the apps on the same OOD server itself. It sounds like in that case OOD_DEV_SSH_HOST is not needed, but, then it should be listed as an “optional” step.
So, bottom line, I recommend itemize and reshuffle the document by first having 2 sub-sections of the necessary steps (the paths to the app_root), and then discuss the optional steps (OOD_DEV_SSH_HOST and the global app development enabling with OOD_APP_DEVELOPMENT).