Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Master's track Gradebook - Bulk Grade Management and Intervention… #1844

Merged
merged 1 commit into from
Sep 30, 2019

Conversation

stroilova
Copy link
Contributor

…s report

DOC-XXXX

Add a description of your changes with links to any relevant material.

Date Needed (optional)

If the release date of a feature is known or estimated, provide it to give reviewers guidance on turnaround time.

Reviewers

Possible roles follow. The PR submitter checks the boxes after each reviewer finishes and gives 👍.

  • Subject matter expert:
  • Subject matter expert:
  • Doc team review (sanity check, copy edit, or dev edit?): @edx/doc
  • Product review:
  • Partner support:
  • PM review:

FYI: Tag anyone else who might be interested in this PR here.

Testing

  • Ran ./run_tests.sh without warnings or errors

HTML Version (optional)

  • Build an RTD draft for your branch and add a link here

Sandbox (optional)

  • Point to or build a sandbox for the software change and add a link here

Post-review

  • Add a comment with the description of this change or link this PR to the next release notes task.
  • Squash commits

Copy link
Contributor

@iloveagent57 iloveagent57 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks pretty good, just a few minor corrections.

This feature is available in courses with a Master’s track, to support bulk grade adjustments or curving. It allows you to override subsection (i.e. assignment or exam) grades for in bulk by uploading a file.

.. note::
Grade overrides apply to all learners enrolled in supported courses, but there is a size limit of 4MB (~10k learners) for uploaded files. If your Master’s track course is bigger than this, you’ll have to upload grading files in chunks.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you have to start the body of your note on the same line as .. note::

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated, thanks


To override grades in bulk, follow these steps.

To view the **Progress** page for a specific learner, follow these steps.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this line was accidentally copied here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Deleted, thanks.


#. Open the CSV in a data editor like Excel.

#. Fill in the new grade column for the assignment you want to override grades for and save the file.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: should be "assignment(s)" since you can modify multiple assignments from the same file.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated, thanks


.. note:: Master’s-only feature

This feature is available in courses with a Master’s track, to support manual learning interventions. It allows you to export per-learner progress and grade information for Master’s track learners, and allow you to identify and reach out to learners who may need additional help.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"...and allows you to..."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated, thanks

Copy link
Contributor

@matthugs matthugs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bit of scope creep after looking at the built docs: we may want to refresh the gradebook UI screencap in shared/images/Learner_Gradebook.png

Here's what that looks like currently in situ:
Screen Shot 2019-09-27 at 3 17 26 PM

en_us/shared/student_progress/course_grades.rst Outdated Show resolved Hide resolved
field. Searches are case-insensitive.

* You can change, or override, the grade that a learner has received for a
specific subsection. For information about how to do this, see
:ref:`Override in Gradebook`.

* [Master’s courses] The edX gradebook has several features for higher-touch courses. For learners in the Master’s track:
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

question: is it high-touch or higher-touch ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we've been using higher-touch to compare Master's to regular MOOCs. However, high-touch may be simpler. Thanks.

This feature is available in courses with a Master’s track, to support bulk grade adjustments or curving. It allows you to override subsection (i.e. assignment or exam) grades for in bulk by uploading a file.

.. note::
Grade overrides apply to all learners enrolled in supported courses, but there is a size limit of 4MB (~10k learners) for uploaded files. If your Master’s track course is bigger than this, you’ll have to upload grading files in chunks.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: ...in supported courses. There is a .... instead of "...courses, but...."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Broke out into two sentences, thanks.

Copy link
Contributor Author

@stroilova stroilova left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bit of scope creep after looking at the built docs: we may want to refresh the gradebook UI screencap in shared/images/Learner_Gradebook.png

Here's what that looks like currently in situ:
Screen Shot 2019-09-27 at 3 17 26 PM

Agreed - we should replace this image. I was thinking of doing two separate commits: this one for the text documentation update, and a second one for the image update.

@stroilova stroilova force-pushed the masters-gradebook-enhancements branch from da4bbaa to c8c4221 Compare September 27, 2019 20:13
Copy link
Contributor

@matthugs matthugs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bit of scope creep after looking at the built docs: we may want to refresh the gradebook UI screencap in shared/images/Learner_Gradebook.png
Here's what that looks like currently in situ:
Screen Shot 2019-09-27 at 3 17 26 PM

Agreed - we should replace this image. I was thinking of doing two separate commits: this one for the text documentation update, and a second one for the image update.

Sounds good! To do that you won't need to --force-with-lease if you create a separate commit for the image change, rather than amending.

@stroilova stroilova merged commit 61d16f9 into master Sep 30, 2019
@nedbat nedbat deleted the masters-gradebook-enhancements branch June 8, 2020 19:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants