Merge pull request #1959 from edx/crice/cert

docs: Update doc for manual course certificate generation

en_us/install_operations/source/configuration/enable_certificates.rst

@@ -345,53 +345,20 @@ these steps.
 #. Save your edits to the certificate template.
 
 
-.. _Generate Certificates for a Course:
-
-**********************************
-Generate Certificates For a Course
-**********************************
-
-To generate certificates for a course, run the ``manage.py`` script with the
-following settings. When the script finishes running, grades are calculated
-for learners who are enrolled in the course, and certificates are generated
-for eligible learners.
-
-#. Obtain the course ID for the course for which you are generating
-   certificates. When you view course content in your browser, the course ID
-   appears as part of the URL. For example, in the URL
-   ``http://www.edx.org/course/course-v1:edX+demoX_Demo_2015``, the course ID
-   is ``course-v1:edX+demoX_Demo_2015``. For some courses, the course ID
-   contains slashes. For example, ``edX/Demox/Demo_2014``.
-
-#. Run ``manage.py`` with the following settings, replacing ``{CourseID}``
-   with the actual course ID. Do not include beginning or trailing slashes.
-
-   ``./manage.py lms --settings=production ungenerated_certs -c {CourseID}``
-
-   For example,
-
-   ``./manage.py lms --settings=production ungenerated_certs -c course-v1:edX+demoX_Demo_2015``.
-
-   .. Note::
-     If the LMS is running on a server that does not have https support (such
-     as a locally run fullstack for testing) you will need to use the
-     ``--insecure`` flag so that the certificate generation service contacts
-     the LMS on http instead of on https.
-
-#. You can then view the certificates in the ``certificates_generatedcertificate`` database table.
-
-
 .. _Enable Automatic Certificate Generation:
 
 ***************************************
 Enable Automatic Certificate Generation
 ***************************************
 
+It is suggested that automatic certificate generation
+be enabled in order to provide the best experience for learners.
 Particularly in self-paced courses (see :ref:`Enable Self Paced
 Courses`), your learners might not want to wait until an instructor
-initiates certificate generation. Instead, they would typically expect
+initiates certificate generation; instead, they would typically expect
 to be able to download their certificates as soon as they achieve a
-passing grade.
+passing grade. This can be achieved by enabling *auto_certificate_generation*
+as described below.
 
 To globally enable this functionality, you must set a `Waffle switch
 <https://waffle.readthedocs.io/en/latest/types/switch.html>`_:
@@ -420,6 +387,39 @@ Learners to Receive Early Certificates` and
 :ref:`opencoursestaff:Allow Learners to Download Certificates` in
 *Building and Running an Open edX Course*.
 
+.. _Manually Generate Certificates for a Course:
+
+*******************************************
+Manually Generate Certificates For a Course
+*******************************************
+
+To manually generate certificates for a course, run the ``manage.py`` script
+with the following settings. When the script finishes running, course certificates
+will have been generated for eligible learners.
+
+#. Obtain the course ID for the course for which you are generating
+   certificates. When you view course content in your browser, the course ID
+   appears as part of the URL. For example, in the URL
+   ``http://www.edx.org/course/course-v1:edX+demoX_Demo_2015``, the course ID
+   is ``course-v1:edX+demoX_Demo_2015``. For some courses, the course ID
+   contains slashes, however it will not contain beginning or trailing slashes.
+   For example, a course id look like ``edX/Demox/Demo_2014``.
+
+#. Obtain the user IDs for any learners for whom you'd like to generate course
+   certificates. These can be found in the ``auth_user`` database table.
+
+#. Run ``manage.py`` with the following settings, replacing {UserID} with a user id
+   and ``{CourseID}`` with the course ID. Do not include beginning or trailing slashes.
+
+   ``./manage.py lms --settings=production cert_generation -u {UserID} {UserID} -c {CourseID}``
+
+   For example,
+
+   ``./manage.py lms --settings=production cert_generation -u 123 456 -c course-v1:edX+DemoX+Demo_Course``
+
+#. You can then view the certificates in the ``certificates_generatedcertificate`` database table.
+
+
 .. include:: ../../../links/links.rst
 
 .. _edx/credentials: https://github.com/edx/credentials

en_us/shared/student_progress/checking_student_progress.rst

@@ -46,7 +46,7 @@ Issuing Certificates
    Before you can issue certificates, the administrator for your instance of
    Open edX must configure the platform to allow course teams to generate and
    issue certificates. For more information, see
-   :ref:`installation:Generate Certificates for a Course` and
+   :ref:`installation:Enable Automatic Certificate Generation` and
    :ref:`installation:Enable Certificates` in *Installing, Configuring, and
    Running the Open edX Platform*.