On 14/03/16 15:59, Jesse Glick wrote:
On Sun, Mar 13, 2016 at 7:53 PM, Christopher Orr <[email protected]> wrote:
I’m trying to work on some of the core documentation, and a lot of it seems to 
be kept away from the core source — in `war/src/main/webapp/help`, where all of 
the files are HTML-only.

Generally I would consider this a deprecated location; help files
should be moved to their conventional locations:

· `core/src/main/resources/pkg/SomeDescribable/help.html`, for the
object as a whole
· `core/src/main/resources/pkg/SomeDescribable/help-someField.html`,
for a particular property

Ahh.. ok, it's good to know that it's considered deprecated.


There are exceptions: help that is not (and cannot easily be)
associated with conventional form binding; or cases where the same
content must be shared between multiple forms.

Right, I've seen a bunch of this in core already.  Makes sense.


At any rate, for files in the recommended locations, it is possible to
replace `.html` with `.jelly` and use dynamic content.

Yup.

Thanks!
Chris


--
You received this message because you are subscribed to the Google Groups "Jenkins 
Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/jenkinsci-dev/56E9FA5E.5070709%40orr.me.uk.
For more options, visit https://groups.google.com/d/optout.

Reply via email to