I can answer the first easily.
It’s a feature for a use case where you want to execute some commands as root before the PUN starts up. For us, it’s to set the kubectl Open ID Connect credentials because apache has the token but we don’t pass those tokens to lower layers like the dashboard. It’s not documented because it’s not stable, we’re still working through some tweaks so things could change with that feature. Much more so with kubernetes. The kubernetes adapter is not very stable and we’re still working through how to stabalize it before we tell folks “yea it’s interface and internal workings are stable enough to start to rely on”.
To the second question, well that’s a bit tougher. I’ll admit that the documentation needs some real work and that’s on us. Things could be said in a simpler way I’m sure.
But I would say that web (html, css and http) knowledge are certainly core to the OnDemand platform. Let’s take this feature for pinning apps. We use the word
widget which I’m now realizing may be a bit esoteric but seems commonplace in web documentation. It’s just a fancy word form “some thing” after all. Then we’re talking rows and column sizes which certainly have meaning outside of the web, but specifically to us we’re talking about the Bootstrap grid system. Bootstrap being the css framework we use, it’s certainly central to the presentation of the pages.
Your question is striking in that it points to something fundamentally missing in our documentation, so I’ll likely think about it for some time. What are the skills our docs take for granted? What can we do to supplement our docs with these web fundamentals?