Uploaded image for project: 'Jira Data Center'
  1. Jira Data Center
  2. JRASERVER-10222

Document the contents of the velocity context for release notes

    • We collect Jira feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      NOTE: This suggestion is for JIRA Server. Using JIRA Cloud? See the corresponding suggestion.

      We have documentation on the contents of the velocity context for email notifications and custom fields, we need one for release notes. From a user:

      What i had trouble with tho was not the velocity side as it is relatively straight forward, but more so the fact that i had no idea what classes i had access to from within the velocity template, or how to add classes (infact i didn't even know you could add classes).

      Once i got over that hurdle, it was just a matter of finding the relevant classes to pass to the release notes in the jira api, so i could gain acces to each issues linked issues.

      I think that some documentation could be added to this affect. ie what classes are initially available to the release notes templates. As well as how to add more classes to this list (through the method getTemplateVariables in ReleaseNoteManager)
      Another issue, which fortunately i didn't come up against as we have the enterprise edition of jira so was able to get the source code for the ReleasenotesManager, edit it, recompile and replace the existing ReleaseNoteManager class file. But if i didn't have enterprise and didn't have access to the source, how would have i gone about this?

      Anyway that just my 2cents on a few things that would have helped me out greatly to avoid the issues that i had. (Judging by the number of views that this thread has had i am guessing i am not the only one who has come up against these issues also)

      Cheers
      Sam

            [JRASERVER-10222] Document the contents of the velocity context for release notes

            Fabian added a comment -

            Nothing changed, right?

            I have the same problem and need a documentation. Is that so hard to produce?????

            Fabian added a comment - Nothing changed, right? I have the same problem and need a documentation. Is that so hard to produce?????

            SusanA added a comment -

            This is developer documentation and is handled on DAC.

            SusanA added a comment - This is developer documentation and is handled on DAC.

            Sam Craig added a comment -

            Just FYI this is the original forum post that prompted this issue, and the comment in the description. http://forums.atlassian.com/thread.jspa?threadID=10891

            Cheers
            Sam

            Sam Craig added a comment - Just FYI this is the original forum post that prompted this issue, and the comment in the description. http://forums.atlassian.com/thread.jspa?threadID=10891 Cheers Sam

            The link above directs to the context of email Velocity Templates.

            People who want to produce their own Release notes need ind out whats in the context for the Release Notes. -

            "action", action,
            "req", ActionContext.getRequest(),
            "issueTypes", issueTypes,
            "appProps", applicationProperties,
            "version", version.getName(),
            "project", project.getString("name"),
            "textUtils", textUtils,
            "constantsManager", constantsManager,
            "customFieldManager", ManagerFactory.getCustomFieldManager()
            

            Nick Menere [Atlassian] (Inactive) added a comment - The link above directs to the context of email Velocity Templates. People who want to produce their own Release notes need ind out whats in the context for the Release Notes. - "action", action, "req", ActionContext.getRequest(), "issueTypes", issueTypes, "appProps", applicationProperties, "version", version.getName(), "project", project.getString("name"), "textUtils", textUtils, "constantsManager", constantsManager, "customFieldManager", ManagerFactory.getCustomFieldManager()

            Nick - can you let me know what docs are required here?

            Scott Farquhar added a comment - Nick - can you let me know what docs are required here?

            Scott Farquhar added a comment - Does this help? http://confluence.atlassian.com/display/JIRA/Contents+of+the+Velocity+Context+for+email+templates Or do we need to do more?

              nick.menere Nick Menere [Atlassian] (Inactive)
              dylan@atlassian.com Dylan Etkin [Atlassian]
              Votes:
              5 Vote for this issue
              Watchers:
              8 Start watching this issue

                Created:
                Updated:
                Resolved: