How To

This page explains how to work with discussion.

Overview

When a subject needs to be discussed then a community member creates a new discussion in a dedicated space (see "Creating a discussion" heading. From that point any other community member can add comments (see "Adding a comment to a discussion" heading) to a discussion to:

• clarify things
• express his own opinion on discussed topic
• ask a question
• etc.

Then another community member (or even member, who created discussion in first place) can add a comment to a discussion itself (see "Adding a comment to a discussion" heading) or to a specific comment in that discussion (see "Reply to comment" heading). If JIRA issue is present in a comment text, then it's considered a best practice to also mention it under "Related Tasks" in discussion text itself (only in case, if it's really related to a discussion).

Creating a discussion

To create a discussion user must:

1. visit Space Directory
2. select space of interest
3. click on "..." button in header (blue row) to open page creation wizard
4. press "create" button to open page editor
5. enter topic & content
6. press Save button at bottom once finished
7. press "l" to open "Labels" dialog
8. type "task-missing" (also can click on auto-completed value)
9. click "Add" button
10. close dialog

Editing a page

1. press "e" (from "edit") to edit a page, that is currency opened
2. press "Save" button at bottom once finished

Adding a comment to a discussion

1. press "m" (from "comment") to added a comment to a page, that is currency opened
2. press "Save" button at bottom (of comment editor) once finished

Replying to a comment

1. click "Reply" link below a comment
2. press "Save" button at bottom (of comment editor) once finished

Adding a file to a discussion

1. start page editing, by pressing "e" (from "edit")
2. insert new line at the end of main discussion text by pressing ENTER
3. drag file of interest over to new line (where cursor is located)
4. repeat other files, that needs to be added 
5. press "Save" button at bottom once finished

Adding a task to discussion

1. create "Related Tasks" heading (if not already present) at the bottom of the discussion:
   1. type "h4" ("h" from "heading"), then "." (dot), then " " (space) to start new H4 heading on current line
   2. type "Related Tasks" and press ENTER to move cursor to new line
2. add JIRA task reference:
   1. press following shortcut to open JIRA Issue Dialog:
      1. Mac: Cmd+Shift+J
      2. Windows, Linux: Ctrl+Shift+J
   2. type Issue Key into search box on the right and press ENTER
   3. select issue (no need if only 1 issue was found) and press ENTER
3. repeat other JIRA issues, that needs to be added 
4. press Save button at bottom once finished
5. press "l" to open "Labels" dialog
6. type "task-created" (also can click on auto-completed value)
7. click "Add" button
8. click "x" next to "task-missing" label
9. close dialog