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:

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

Editing a page

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

Adding a comment to a discussion

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

Replying to a comment

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

Adding a file to a discussion

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

Adding a task to discussion

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
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
repeat other JIRA issues, that needs to be added
press Save button at bottom once finished
press "l" to open "Labels" dialog
type "task-created" (also can click on auto-completed value)
click "Add" button
click "x" next to "task-missing" label
close dialog

Browser not supported