Figma mockups supporting documentation

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

 

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?