Access to Review Materials
You will need to log in or register for the CDISC Wiki to access documents and provide comments.
- To register for the Wiki: Register. JIRA and Wiki use the same login, please create only one account.
CDISC Wiki is a different login from www.cdisc.org. A cdisc.org login is not required for Public Review.
Conformance Rules
The associated conformance rules for this release are available here: TIG Conformance Rules v1.0
Thank you for reviewing the TIG Conformance Rules v1.0 package, which encompasses all current conformance rules for TIG v1.0.
The package for Public Review includes:
- TIG Conformance Rules v1.0: an Excel spreadsheet containing the TIG Conformance Rules v1.0.
- A READ ME tab has been included on the spreadsheet as the 1st tab and explains all of the information provided in the spreadsheet and the columns for each rule.
To comment on a Rule:
- Select "Enter Comment" from the page tree on the left-hand pane.
- Enter the following information in the comment form:
- Rule Identification: Identify the Rule ID (from the Excel file)
- Summary: Add a short "Summary" of the topic of your comment in the "Summary" box
- Comment: Add a full description of your comment in the "Description" box and click SUBMIT at the bottom.
- The JIRA issue has now been created for the item you have just entered.
Rule Identification * | Identify the rule you wish to comment on by entering the number value in the "Rule ID" column: e.g., SEND9 |
---|---|
Summary * | |
Comment * |
To add comments to JIRA from within the Wiki:
- Select the text to which you wish to attach the comment. After a moment, a small contextual menu should appear.
If the text you have selected is not unique on the page, or contains any links or images, the JIRA Connector will be unable to find the right place to automatically insert the issue upon creation. In most cases, five words of plain text should be enough to ensure a unique text string, but this is not guaranteed.
Depending on your browser, the JIRA Connector may also experience difficulties if the content to which you wish to add the issue is mirrored from another page. Reviewers are recommended to enter comments on the content's source page whenever feasible.
This method only works for text and content rendered on the wiki page(s). Comments on files attached to the document must be entered manually in Jira. Please reference the file and location within when creating your issue.
See "To add comments from within JIRA" below.
- Within the contextual menu, click on the icon with the 3 arrows . 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 "SEND Comments" in the drop-down menu on the top left for Project, if it is not already chosen.
- Choose Component "DART"
- Choose "Review Comments" in the drop-down menu on the top right for Issue Type (if it is not already chosen).
- Fill out the form and click the "Create" button in the bottom right corner of the form to submit your comment as an issue.
In case of technical difficulties, please make sure to provide a brief description of the context of your comment, so the team can address it properly.
- The page should automatically update with your comment inserted in place.
If you get a notice that the issue "has been created, but there is a problem in adding it to the page," you can click on the key in the notice to open the issue just created in JIRA, and then insert it into the page manually.
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
To add comments from within JIRA:
- Go to the "SEND Comments" project in JIRA at: https://jira.cdisc.org/projects/SENDCOMNTS
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 "SEND Comments" 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. To help the team address your comment properly, be thorough.
- 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.
Instructions for creating an issue can be found here: https://confluence.atlassian.com/display/JIRA/Creating+an+Issue
If you have no edits or comments to a page:
- Click 'Like' at the bottom of the page. This will help us determine who has read each page.