Figma mockups supporting documentation

  • This document attempts to capture details of some features in the Figma mockups (https://www.figma.com/file/LVFnO9oRHYiamoicZuXDAC/Discussion-page?node-id=1604%3A1338).

  • 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

 

Roles and rights

 

Admin/ Course author

Discussion Admin

Discussion Moderator

Community TA

Group Community TA

Learner

 

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

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:

My posts

When My posts is selected in the navigation bar.

Mockup

Features

Mockup

Features

  1. Filter sort bar

  2. 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 see it in the view pane (see here).

  • What does the List pane show if current user has not authored any posts? @Jon F

  • If 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

Mockup

Features

  1. Filter sort bar

  2. 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 spacing.

    1. How many posts will be initially loaded? @Kshitij Sobti

      1. Large display should be able to see full left pane at low zoom levels.

    2. Will posts be automatically loaded upon scroll? @Jon F

      1. If so, how many will be loaded next considering performance? @Kshitij Sobti

  3. Pinned posts will appear on top

    1. Pinned post cards will be spaced from other posts.

    2. All pinned posts be shown on top? @Jon F

    3. Do we want to put a limit on number of posts that can be pinned? @Jon F

    4. How will multiple pinned posts be sorted? @Jon F

    5. Do filter and sort apply on pinned posts? @Jon F

Users can click on a post summary card to see it in the view pane (see here).

What does the List pane show if no posts exist? @Jon F

Topics

Mockups

Features

Mockups

Features

  1. Search bar for topics.

  2. Course-wide topics will always be listed on top. Confirm? @Jon F

  3. Categories and subcategories are listed after the course-wide topics. Subcategories for each category are listed after the category.

    1. What is the default sort order for these? Sort by created?

Clicking anywhere on the topic summary card for course-wide topics and subcategory will render the list of posts in that topic.

Posts i'm following topic in legacy experience has now been moved to filters.

Clicking anywhere on the topic post card for category topic lists topic post cards for all subcategories in that category.

  1. Once a category topic is selected, the breadcrumb bar would appear. Breadcrumb bar will have categories and subcategories, selectable as a drop down menu.

  2. Search bar will remain there.

  3. Selected category topic will be listed on top.

  4. Topic summary cards for subcategories belonging to the selected category will be listed below.

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.

  1. Once a course-wide topic or subcategory topic is selected, the breadcrumb bar would appear.

  2. Filter sort bar

  3. Post summary cards belonging to selected subcategory.

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

Mockups

Features

When viewing a post in view pane, the layout will be as follows:

  1. Post view area

  2. Response view area

  3. Comment view area (inside parent response area)

  4. Button to load more comments

    1. How many comments will be loaded by default? @Jon F

  5. Button to load more responses

    1. How many responses will be loaded by default? @Jon F

  6. Button for adding a response

  7. Button for adding a comment

  8. Sort by: By post time

    1. What other sorting options need to be there?

  9. Number of responses being shown

Post view area

  1. Post title

  2. Username

  3. Avatar with icon (same logic as here)

  4. Post content

  5. More actions (more details)

  6. Post topic

  7. Following (Filled if logged-in user is following)

  8. Liked (Filled if logged-in user has liked the post)

  9. Time lapsed since creation

Where show what group is this post visible to (for admins, moderators and TAs)? @Jon F

Response view are

  1. Avatar

  2. Username

  3. Icon but what does it represent? TA or Staff?

  4. Response content

  5. Button to mark response as answer (by post author, moderator and staff)

  6. More options for response (more details)

  7. Like button with number of likes. Filled if logged-in user has liked response.

    1. Who will it be visible to?

  8. Time elapsed since response creation

  9. Comment area having a single comment

    1. What will multiple comments look like? @Jon F

  10. Username

  11. Avatar

  12. Comment content

  13. Time elapsed since comment creation

  14. 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

 

  1. Selection of post type

  2. Selection of post topic area (only leaf nodes selectable)

  3. Select for cohort visibility (shown to staff and moderators)

    1. Maybe rename this to “Group visibility” because groups created by enrolment tracks will also show up here?

  4. Post title input

  5. Post content input

  6. Follow post option

    1. True by default

  7. Post anonymously

    1. False by default

  8. Cancel post creation

    1. Where is user re-routed to?

  9. Submit post

    1. User is re-routed to created post.

    2. What will the list/nav pane look like after re-routing? My posts?


v1.16

  1. Selection of post type includes bug/issue

Filter sort bar

Mockup

Features

Mockup

Features

For My posts and All posts:

  1. Button to open filter and sort menu.

  2. Selected filter and sort.

  3. Left two columns contain filtering options

  4. Right column contains sort options for posts

  • What filter and sort options should be available for My posts? For example Reported and Following 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 since Questions can be unread too. @Jon F

@Jon F your kind feedback is requested on filters and sorts below.

 

My posts

All posts/ Topics

 

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

Mockup

Features

A typical post summary card contains:

  1. Avatar with icon

  2. Post title

  3. Username

  4. Initial few words of the post that can fit within one line in the card

  5. Like button (Filled if post already liked)

    1. Is like button clickable on summary card? @Jon F

    2. What appearance for mouse-over? @Jon F

  6. Follow button (Filled if post already followed)

    1. Is follow button clickable on summary card? @Jon F

    2. What appearance for mouse-over? @Jon F

  7. Total number of responses on the post

    1. Are comments included in the count? @Jon F

  8. 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):

  1. for type Discussion (no icon)

  2. for type Question

  3. for type Bug/issue

Posts with type Question and Bug/issue may have additional labels (see image left):

  1. A Question will have a label Answered, if it has been marked as answered.

  2. A Bug/issue will have a label Resolved, if it has been marked as resolved.

    1. Who can mark?

    2. Will there be additional roles for bug/issue?

 

  • How cards for unread posts will be rendered?

 

  • How will the count for unread comments/responses be shown? @Jon F

 

  • How will a reported post summary card with Reported identifier be rendered?

    • As seen on the left.

Topic summary card

Mockup

Features

Mockup

Features

Summary card for General topics and Subcategory looks like this

  1. General topic or subcategory name

  2. Number of posts with type Discussion

  3. Number of posts with type Question

  4. Number of posts that have been reported in this topic (visible only to moderators/admins/TAs)

    1. Does this icon show up if responses or comments have been reported as well?

      1. Yes

    2. Does the count included responses and comments as well?

      1. Yes

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

Mockup

Features

Admin, staff, moderators and TAs can close a post.

Responses and comments cannot be posted on a closed post.

Clicking on Close post option will immediately close a post.

  1. Closed post is marked along with the user that closed it.

    1. Add a response button will disappear from the post view area.

    2. Add a comment button will disappear from responses on the closed post?

      1. Yes

  2. An icon marks the closed post. Mouse-over indicates that post is closed.

    1. Time elapsed will be shown for closed post? If so, where?

      1. Yes. Time will be shifted towards left when post close icon is present.

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.

How to report a message

Reported message appearance

All users except learners will be able to see reported status of messages.

In view pane

  1. How will a reported post appear in the view pane? @Jon F

  2. How will a reported response appear in the view pane? @Jon F

    1. Will reported responses be moved to the top?

      1. No

  3. A reported comment will look like this in the view pane:

    1. Will reported comments be moved to the top?

      1. No

Appearance of reported comment

In post summary card

  1. What will be the appearance of post summary card for a post that has been reported?

  2. What will be the appearance of post summary card for a post, that has a response which has been reported?

  3. What will be the appearance of post summary card for a post, that has a response, that has a comment which has been reported?

  4. 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

  1. In topic summary card shown below:

    1. I’m assuming that the reported indicator will show up if any type of message has been reported

      1. Yes

    2. The reported count will be the count of messages rather than posts

      1. Yes

Topic summary card containing reported messages

In learner summary card

  1. In learner summary card shown below:

    1. I’m assuming that the reported indicator will show up if any type of message has been reported.

      1. Yes

    2. The reported count will be the count of messages rather than posts.

      1. Yes

Learner summary card with reported messages