This document attempts to explain features in the Figma mockups (https://www.figma.com/file/LVFnO9oRHYiamoicZuXDAC/Discussion-page?node-id=1604%3A1338 ) and answer some of the questions that may arise during implementation and testing. The questions are coloured in red. This document does not capture any alignment, color or spacing information.
Users can be learners or moderators or admins or TAs or staff or content authors
Messages can be post or response or comment
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Roles and rights
Admin/ Course author
Discussion Admin
Discussion Moderator
Community TA
Group Community TA
Learner
Typically assigned to:
-
Admin
Staff
Learner
Learner
-
Actions
post or response or comment
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Roles and rights
Admin/ Course author | Discussion Admin | Discussion Moderator | Community TA | Group Community TA | Learner | ||||
---|---|---|---|---|---|---|---|---|---|
Typically assigned to: | - | Admin | Staff | Learner | Learner | - | |||
Actions | |||||||||
Create a message | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | |||
Edit a message | - | Yes | Yes | Yes | Yes (within group) | Yes (created by self) | |||
Delete a message | - | Yes | Yes | Yes | Yes (within group) | Yes (created by self) | |||
Report a message | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | |||
Un-report a message | - | Yes | Yes | Yes | Yes (within group) | Yes (reported by self) | |||
Vote/un-vote a message | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | |||
Follow/ unfollow a post | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | |||
Edit a messageSee all posts | - | Yes | Yes | Yes | Yes (within group) | Yes (created by selfwithin group) | |||
Delete a messageFilter unread posts | - | Yes | Yes | Yes | Yes (within group) | Yes (created by selfwithin group) | |||
Report a messageFilter unanswered posts | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | Un-report a message | - | |
Sort by recent activity/ most activity/ most votes | - | Yes | Yes | Yes | Yes (within group) | Yes (reported by self) | Vote/un-vote a messagewithin group) | ||
Mark response as correct answer | - | Yes | Yes | Yes | Yes (within group) | Yes (within groupresponses on own posts) | |||
FollowClose/ unfollow re-open a post | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | See all postsNo | ||
Pin/ unpin a post | - | Yes | Yes | Yes | Yes (within group)Yes (within group) | No | |||
Filter unread reported posts | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | Filter unanswered postsNo | ||
Select visibility of post when creating | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | Sort by recent activity/ most activity/ most votesNo | No | |
View visibility of a post | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) | Mark response as correct answer | - | No |
View posts of a specific group | - | Yes | Yes | Yes | No | No | |||
Grant/revoke "Discussion Moderator" role | Yes | Yes (within group) | Yes (responses on own posts) | ||||||
Close/ re-open a post | - | Yes | Yes | Yes | Yes (within group) | No | |||
Pin/ unpin a post | - | Yes | Yes | Yes | Yes (within group) | No | |||
Filter reported posts | - | Yes | Yes | Yes | Yes (within group) | No | |||
Select visibility of post when creating | - | Yes | Yes | Yes | No | No | |||
View visibility of a post | - | Yes | Yes | Yes | Yes | No | |||
View posts of a specific group | - | Yes | Yes | Yes | No | No | |||
Grant/revoke "Discussion Moderator" role | Yes | No | No | No | No | No | |||
Grant/revoke "Discussion Admin" role | Yes | No | No | No | No | No | |||
Grant/revoke "Community TA" role | Yes | No | No | No | No | No | |||
Grant/revoke "Group Community TA" role | Yes | No | No | No | No | No |
Layout of Discussion
tab in course
Navigation bar
v1.6
Has 3 tabs:
My posts
,All posts
,Topics
Selected tab is filled as shown below
v1.9
Has 4 tabs:
My posts
,All posts
,Topics
,Learners
List pane
List pane contains:
Filter sort bar on top.
Stacked summary cards for:
Posts, if
My posts
orAll posts
is selected in navigation bar.Topics, if
Topics
is selected in navigation bar.Leaners, if
Learners
is selected in navigation bar. v1.9
A scroll bar to scroll through the list. Jon F
My posts
When My posts
is selected in the navigation bar.
Mockup
Features
Summary cards for posts authored by current user, filtered and sorted, are stacked in the
List pane
with no spacing.
User can click on a post summary card to view it in the View pane.
What does the
List pane
show if current user has not authored any posts? Jon FIf user has authored any posts that have been pinned, does they show up here? Jon F
If so, do they show on top, spaced from the rest of the post summary card?
What if the user wants to see authored responses and comments? Jon F
All posts
When All posts
is selected in the navigation bar.
Mockup
Features
Summary cards for all posts that are allowed to be viewed by the current user, filtered and sorted, are stacked in the
List pane
with no spacingHow many posts will be initially loaded? Kshitij Sobti
Large display should be able to see full left pane at low zoom levels.
Will posts be automatically loaded upon scroll? Jon F
If so, how many will be loaded next considering performance? Kshitij Sobti
Pinned posts will appear on top
Users can click on a post summary card to view it in the View pane
(details here)
What does the List pane
show if no posts exist? Jon F
Topics
Mockups
Features
Search bar for topics.
General topics will always be listed on top. Confirm? Jon F
Categories and subcategories are listed after the general topics.
Number of
Discussion
posts in this subcategory. Clicking this icon will open all posts in this subcategory that have typeDiscussion
.Number of
Question
posts in this subcategory. Clicking this icon will open all posts in this subcategory that have typeQuestion
.Number of posts that have been reported in this subcategory. Clicking this icon will open all posts in this subcategory that have been reported.
Posts i'm following
topic in legacy experience has now been moved to filters.
Once a topic is selected, the breadcrumb bar would appear. Breadcrumb bar having categories and subcategories, selectable as a drop down menu.
Drop down for subcategory. Show all
option shows all subcategories in the selected category.
Drop down for category. Show all
option shows all discussion categories.
Selecting a subcategory lists all posts in that subcategory.
v1.7 What filters and sorting options should be available for
Topics
?We decided to skip the filter/sort options for topics. We’ll figure that out at a later date.
View pane
Is used to view posts/threads and create a post.
It needs to have a scroll bar.
View post
When viewing a post in view pane, the layout will be as follows:
Post box
Response box
Comment box (inside parent response box)
Load more comments
How many comments will be loaded by default? Jon F
Load more responses
How many responses will be loaded by default? Jon F
Button for adding a response
Button for adding a comment
Sort by:
By post time
What other sorting options need to be there?
Number of responses being shown
View pane > View post > Post box
Post title
Username
Avatar with icon (same logic as here)
Post content
More actions (more details)
Post topic
Following (Filled if logged-in user is following)
Liked (Filled if logged-in user has liked the post)
Time lapsed since creation
How show what group is this post visible to (for admins, moderators and TAs)? Jon F
View pane > View post > Response box
Avatar
Username
Icon but what does it represent? TA or Staff?
Response content
Button to mark response as answer.
More options for response (more details)
Like button with number of likes. Filled if logged-in user has liked response.
Who will it be visible to?
Time elapsed since response creation
Comment box having a single comment
What will multiple comments look like? Jon F
Username
Avatar
Comment content
Time elapsed since comment creation
More options for comment (more details)
Response marked as answer looks like this.
Response marked as answer moves towards the top of the list and is rendered separately. Jon F can you please describe or add to mockups, how the response marked as answered will be rendered differently compared to other responses? Is there any spacing etc?
Add a post
Mockup
Features
Selection of post type
Selection of post topic area (only leaf nodes selectable)
Maybe rename this to “Group visibility” because groups created by enrolment tracks will also show up here?
Post title input
Post content input
Follow post option
True by default
Post anonymously
False by default
Cancel post creation
Where is user re-routed to?
Submit post
User is re-routed to created post.
What will the list/nav pane look like after re-routing? My posts?
Filter sort bar
Mockup
Features
For My posts
and All posts
:
Button to open filter and sort menu.
Selected filter and sort.
Left two columns contain filtering options
Right column contains sort options for posts
What filter and sort options should be available for
My posts
? For exampleReported
andFollowing
shouldn’t be there.Should
Reported
be only available to moderators?Reported
should only be visible to staff, admins and community TAs.
If user selects
Unanswered
,Questions
is selected automatically.If user selects
Unread
,Discussions
is selected automatically. This should not be the case sinceQuestions
can be unread too. Jon F
Jon F your kind feedback is requested on filters and sorts below.
My posts
All posts/ Topics
Learner
Admin/moderator/TA
Search bar
Searches within post title and content
Post summary card
Post summary cards are listed in the list pane and offer some information about the users so that users can scroll through and:
Select a post to view it in the view pane
Like a post
Follow a post
Mockup
Features
A typical post summary card contains:
Avatar with icon
Post title
Username
Initial few words of the post that can fit within one line in the card
Like button (Filled if post already liked)
Follow button (Filled if post already followed)
Total number of responses on the post
Are comments included in the count? Jon F
Time elapsed since posted (integer with short notation for seconds, minutes, hours, days, weeks, months and years)
Selected post summary card will have a grey background and a vertical bar on the right.
Appearance of icons near avatar will vary depending on the post type (see image left):
for type
Discussion
(no icon)for type
Question
for type
Bug/issue
Posts with type Question
and Bug/issue
may have additional labels (see image left):
A
Question
will have a labelAnswered
, if it has been marked as answered.A
Bug/issue
will have a labelResolved
, if it has been marked as resolved.Who can mark?
Will there be additional roles for bug/issue?
No | No | No | No | No | ||
Grant/revoke "Discussion Admin" role | Yes | No | No | No | No | No |
---|---|---|---|---|---|---|
Grant/revoke "Community TA" role | Yes | No | No | No | No | No |
Grant/revoke "Group Community TA" role | Yes | No | No | No | No | No |
Layout of Discussion
tab in course
Anchor | ||||
---|---|---|---|---|
|
Navigation bar
v1.6
Has 3 tabs:
My posts
,All posts
,Topics
Selected tab is filled as shown below
v1.9
Has 4 tabs:
My posts
,All posts
,Topics
,Learners
Anchor | ||||
---|---|---|---|---|
|
List pane
List pane contains:
Filter sort bar on top.
Stacked summary cards for:
Posts, if
My posts
orAll posts
is selected in navigation bar.Topics, if
Topics
is selected in navigation bar.Leaners, if
Learners
is selected in navigation bar. v1.9
A scroll bar to scroll through the list. Jon F
My posts
When My posts
is selected in the navigation bar.
Mockup | Features |
---|---|
User can click on a post summary card to see it in the view pane (see here).
|
All posts
When All posts
is selected in the navigation bar.
Mockup | Features |
---|---|
Users can click on a post summary card to see it in the view pane (see here). What does the |
Topics
Mockups | Features |
---|---|
Clicking anywhere on the topic post card for General topics and subcategory will render the list of posts in that topic.
| |
Clicking anywhere on the topic post card for Category lists topic post cards for all subcategories in that category.
| |
Drop down for subcategory. | |
Drop down for category. | |
| Selecting a subcategory lists all posts in that subcategory. |
|
Anchor | ||||
---|---|---|---|---|
|
Breadcrumb bar
Anchor | ||||
---|---|---|---|---|
|
View pane
Is used to view posts/threads and create a post.
It needs to have a scroll bar.
Anchor | ||||
---|---|---|---|---|
|
View post
| |
View pane > View post > Post box
| |
View pane > View post > Response box
| |
|
Anchor | ||||
---|---|---|---|---|
|
Add a post
Mockup | Features |
---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Filter sort bar
Mockup | Features |
---|---|
For
|
Jon F your kind feedback is requested on filters and sorts below.
My posts | All posts/ Topics | |
---|---|---|
Learner | ||
Admin/moderator/TA |
Anchor | ||||
---|---|---|---|---|
|
Search bar
Searches within post title and content
Anchor | ||||
---|---|---|---|---|
|
Post summary card
Post summary cards are listed in the list pane and offer some information about the users so that users can scroll through and:
Select a post to view it in the view pane
Like a post
Follow a post
Mockup | Features |
---|---|
A typical post summary card contains:
| |
Selected post summary card will have a grey background and a vertical bar on the right. | |
Appearance of icons near avatar will vary depending on the post type (see image left):
| |
Posts with type
| |
Anchor | ||||
---|---|---|---|---|
|
Topic summary card
Mockup | Features |
---|---|
Summary card for General topics and Subcategory looks like this
| |
Summary card for Category looks like this. |
Anchor | ||||
---|---|---|---|---|
|
Learner summary card
Icons
Reported content
Reporting a message
Users can click on More
on a message and select Report
to report a message.
Reported message appearance
All users except learners will be able to see reported status of messages.
In view pane
How will a reported post appear in the view pane?
How will a reported response appear in the view pane?
Will reported responses be moved to the top?
A reported comment will look like this in the view pane:
Will reported comments be moved to the top?
In post summary card
What will be the appearance of post summary card for a post that has been reported?
What will be the appearance of post summary card for a post, that has a response which has been reported?
What will be the appearance of post summary card for a post, that has a response, that has a comment which has been reported?
If a post has a response or a comment that has been reported, will that post be loosely categorised as “Reported” for sort and filter purposes? If not, then how will moderators filter and sort for reported responses and comments?
In topic summary card
In topic summary card shown below:
I’m assuming that the reported indicator will show up if any type of message has been reported
The reported count will be the count of messages rather than posts
In learner summary card
In learner summary card shown below:
I’m assuming that the reported indicator will show up if any type of message has been reported
The reported count will be the count of messages rather than posts