Figma mockups supporting documentation
This document attempts to capture details of some features in the Figma mockups (Discussions).
Everything in this document applies to v1.6. Information specific to other milestones is mentioned along with the milestone number in green text.
Questions are coloured in red.
This document does not capture any alignment, colour 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
- 1 Roles and rights
- 2 Layout of Discussion tab in course
- 3 Navigation bar
- 4 List pane
- 5 Breadcrumb bar
- 6 View pane
- 6.1 View post
- 6.2 Post view area
- 6.3 Response view are
- 6.4 Add a post
- 7 Filter sort bar
- 8 Search bar
- 9 Post summary card
- 10 Topic summary card
- 11 Learner summary card
- 12 Icons
- 13 Editing
- 14 Closing
- 14.1 Closing a post
- 15 Reporting
- 15.1 Reporting a message
- 15.2 Reported message appearance
- 15.2.1 In view pane
- 15.2.2 In post summary card
- 15.2.3 In topic summary card
- 15.2.4 In learner summary card
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) |
See all posts | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) |
Filter unread posts | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) |
Filter unanswered posts | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) |
Sort by recent activity/ most activity/ most votes | - | Yes | Yes | Yes | Yes (within group) | Yes (within group) |
Mark response as correct answer | - | Yes | Yes | 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 |
---|---|
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 summary card for course-wide topics and subcategory will render the list of posts in that topic.
| |
Clicking anywhere on the topic post card for category topic lists topic post cards for all subcategories in that category.
| |
Clicking anywhere on the topic summary card for course-wide and subcategory topics will render the list of summary cards for posts in that topic.
| |
Selecting course-wide topics will render a single level of hierarchy in breadcrumb bar. |
v1.7
What filters and sorting options should be available for Topics
?
We decided to skip the filter/sort optx ions for topics. We’ll figure that out at a later date.
Breadcrumb bar
View pane
Is used to view and create messages.
It needs to have a scroll bar.
View post
Mockups | Features |
---|---|
When viewing a post in view pane, the layout will be as follows:
| |
Post view area
Where show what group is this post visible to (for admins, moderators and TAs)? @Jon F | |
Response view are
| |
|
|
Add a post
Selection of post type
Selection of post topic area (only leaf nodes selectable)
Select for cohort visibility (shown to staff and moderators)
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?
v1.16
Selection of post type includes bug/issue
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 |
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:
| |
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
| |
|
|
|
|
|
|
Topic summary card
Mockup | Features |
---|---|
Summary card for General topics and Subcategory looks like this
| |
Summary card for Category looks like this. |
Learner summary card
Icons
Editing
Moderators/TAs and staff can edit messages.
Closing
Closing a post
Mockup | Features |
---|---|
Admin, staff, moderators and TAs can close a post. Responses and comments cannot be posted on a closed post. Clicking on | |
| |
Admin, staff, moderators and TAs can reopen a closed post. |
Reporting
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? @Jon F
How will a reported response appear in the view pane? @Jon F
Will reported responses be moved to the top?
No
A reported comment will look like this in the view pane:
Will reported comments be moved to the top?
No
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
Yes
The reported count will be the count of messages rather than posts
Yes
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.
Yes
The reported count will be the count of messages rather than posts.
Yes