Reviewers are requested to provide comments via JIRA, which uses the same credentials as the Wiki. CDISC Wiki is a different login from www.cdisc.org.
New variables are marked by NEW.
Strike through text in the "Implementation Notes" column represents definition-like text removed. This text will not appear in the version for public review or in the final standard.
Related Documents
If you have no comments on a page:
- Click 'Like' at the bottom of the page. This will help us determine who has read each page.
To add comments to JIRA from within the Wiki:
Select a string of text of approximately five to fifty words leading up to the point at which you wish to enter your comment.
The string of text you have selected acts as the pattern by which the JIRA Connector locates the correct place to automatically insert the issue upon creation. This means that it must be unique within the page, and it must be able to be parsed as a regular expression, or the JIRA Connector will be unable to insert your comment.
Therefore, a single line of plain text, void of any complex content (e.g., hyperlinks, images), and of sufficient length that searching for it using your browser's Find command will return only one result, is recommended.
- After a moment, a small contextual menu should appear.
- Within the contextual menu, click the JIRA icon. This will trigger an abbreviated Create Issue form.
- If you get a notice that "Atlassian JIRA needs your permission to connect to Confluence" instead, click on "Allow", and then "Allow" again. When you are returned to the page in the Wiki, the Create Issue form should be open.
- Choose the project associated with this document (XXX) from the Project drop-down menu
- To correct the project, click on "Edit" on the same line to convert the line into two drop-down menus.
- Choose "XXX" from the first drop-down menu.
- Choose "Review Comments" from the Issue Type drop-down menu.
Fill out the form.
- The Summary field will be pre-populated with the text that you selected. You can change this or leave it as it is.
- Enter your comment, and any additional details, in the Description field. Please be thorough so your comment can be addressed properly.
In case of technical difficulties, please make sure to include a brief description of the context of your comment
- Click the "Create" button in the bottom left corner of the form to submit your comment as an issue. The page should automatically update with your comment inserted in place.
Instructions for creating an issue from within Confluence (the WIKI) can be found here: https://confluence.atlassian.com/doc/use-jira-applications-and-confluence-together.html
How to provide comments in JIRA:
- Go to the project in JIRA at: XXX
- Click on the "Create" button in the top menu to bring up the Create Issue form.
- Choose "Review Comments" from the Issue Type drop-down menu.
- Complete the form.
- Include the name of the page/section in the Summary.
- Provide a description of the issue in the Description. Please be thorough so your comment can be addressed properly.
- Click the "Create" button in the bottom right corner of the form to submit.
Instructions for creating an issue from within JIRA can be found here: https://confluence.atlassian.com/display/JIRA/Creating+an+Issue
- Go to the "SDTM" project in JIRA at: https://jira.cdisc.org/projects/SDTM/issues
Keeping JIRA open in a separate window to capture comments is easier than navigating back and forth between the Wiki and JIRA.
- Click on the "Create" button in the top menu to bring up the Create Issue form.
- Make sure the Project is set to "SDTM" and the Issue Type is set to "Review Comments".
- Fill out the form.
- In the Summary field, describe the content to which the comment applies.
- Enter your comment, and any additional details, in the Description field. Please be thorough so your comment can be addressed properly.
- Click the "Create" button in the bottom right corner of the form to submit.
Next to the "Create" button is an option to "Create another". If this is checked, clicking "Create" will submit your comment and bring up a new Create Issue form with the same project and review type. This can be handy if you have multiple comments to enter.