Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Repair Jira Macros

Feature Overview

Page Properties

CategoryCommunity Application
DocumentationLINK TBD
User ImpactAs a learner I am able to engage in the community of learners also in my course, guiding and supporting my learning experience
Developer GuideDiscussions Developer Guide

titleAdditional documentation details...

Feature Category List,

JIRA Issues

Jira Charts
serverJIRA (

titleProject Listing...

Page Properties

Project Listing

Page Properties Report
headingsProject Status, Delivery Timeline
cqllabel = "feature-discussions"

Current Architectural Diagram (Dec 2015)

Forums 2016

Forums 2016 Google Drive folder
User Story Mapping 

Discussion API

Originally developed for Mobile, these docs are hosted under Mobile, but this API may serve as the basis of all future Discussion work.

Discussion API

Teams Discussion


Docs Guides

edX Learner’s Guide: Course Discussions

Building and Running an edX Course: Managing Course Discussions


Category: See separate Glossary for Category related definitions.

Comment: A discussion has up to 3 levels of discussion related hierarchy: a) Post, b) Response, c) Comment.  Each of these is stored in the Comment Service.

Comment Thread: A synonym for Post, used by the Comment Service to describe a top-level comment.

Comment Service: Name of separately deployed Ruby-based service that handles commentables.  Discussion Forums are the one and only use of the Comment Service (inside edX).

Course Discussion: The term used to describe discussions in our public docs.

Discussion: 1) The most popular end-user term for our discussion forums.  Also used in the name of our newest Discussion API (used by mobile applications). 2) One of two types of posts.  The other type of post is a Question.

Forum: Sometimes used as a synonym for Discussion.  It sometimes appears in UI (e.g. Report Forum Misuse).  Forum Service also used as a synonym of Comment Service.  The term Forum is also used in code related to Forum Roles.

Question: One of two types of Posts.  The other type is a Question.

Post: See Comment.

Response: See Comment.

Topic: See separate Glossary for Category related definitions.

Discussions Persistence


Database Usage (Dec 2015)

  • Comments Service (Mongo)

    • Comments, Threads, and Votes

  • Users (MySql)

    • Forums Roles

  • Modulestore

    • Discussions Module and Discussions Topics

  • TODO: Determine where this data is stored:

    • User Digest Preference (Notifier)

    • User Comment read status

Sample Comment Service Mongo Record (Dec 2015):

Code Block
"_id" : ObjectId("563915bc56c02c19a8000001"), 
"votes" : { 
"up" : [ ], 
"down" : [ ], 
"up_count" : 0, 
"down_count" : 0, 
"count" : 0, 
"point" : 0 
"visible" : true, 
"abuse_flaggers" : [ ], 
"historical_abuse_flaggers" : [ ], 
"thread_type" : "discussion", 
"context" : "course", 
"comment_count" : 3, 
"at_position_list" : [ ], 
"title" : "Test post", 
"body" : "Here is my test post", 
"course_id" : "course-v1:edX+DemoX+Demo_Course", 
"commentable_id" : "cba3e4cd91d0466b9ac50926e495b76f", 
"_type" : "CommentThread" [or "Comment"],
"anonymous" : false, 
"anonymous_to_peers" : false, 
"closed" : false, 
"author_id" : "4", 
"author_username" : "staff", 
"updated_at" : ISODate("2015-11-03T20:14:52.632Z"), 
"created_at" : ISODate("2015-11-03T20:14:52.632Z"), 
"last_activity_at" : ISODate("2015-11-12T18:08:59.691Z")