From aa418f5ecca9eb7d909b574528912207a029ffbc Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Wed, 4 Dec 2024 15:37:29 -0300 Subject: [PATCH 01/10] fc-0068 docs: creating quickstart_rst_doc_creation create_courst.txt transformed to rst doc. --- .../educators/quickstarts/create_course.rst | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 source/educators/quickstarts/create_course.rst diff --git a/source/educators/quickstarts/create_course.rst b/source/educators/quickstarts/create_course.rst new file mode 100644 index 000000000..4c31f7db3 --- /dev/null +++ b/source/educators/quickstarts/create_course.rst @@ -0,0 +1,38 @@ + +########################## +Create a New Course Screen +########################## + +.. tags:: educator, quickstart + +.. thumbnail:: /_images/Educators_create_course.png + + .. Note:: + :class: dropdown + + The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: + + ``https://your-domain/courses/course-v1:ORGANIZATION+COURSE_NUMBER+COURSE_RUN/`` + + So take care when entering values for the new course. + +1. Open Studio at the URL provided by your administrator. + +2. Click :guilabel:`New Course`. The Create a New Course screen opens. + +3. Enter information for the new course: + + * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. + + * **Organization**: Your school or organization. This value becomes part of the course URL and cannot be changed. You can override how the organization is displayed to learners in Advanced Settings. + + * **Course Number**: The unique number that identifies your course. Note: This value becomes part of the course URL and cannot be changed. No spaces or special characters are allowed. + + * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. + +4. Click :guilabel:`Create`. + +You are then taken to the empty Outline page in Studio. + + + From 0f1e2ad80ddbeebc9bd9ae33f7f2b7fd556678c5 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Mon, 16 Dec 2024 16:49:41 -0300 Subject: [PATCH 02/10] adding toc --- source/educators/how-tos/create_course.rst | 41 +++++++++++++++++++--- 1 file changed, 37 insertions(+), 4 deletions(-) diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst index 7fcfc504b..130decd8f 100644 --- a/source/educators/how-tos/create_course.rst +++ b/source/educators/how-tos/create_course.rst @@ -1,6 +1,39 @@ -Create a Course -############### -.. tags:: educator, how-to +########################## +Create a New Course Screen +########################## -.. include:: reusable_content/create_course.txt +.. tags:: educator, quickstart + +.. contents:: Contents + :depth: 1 + :local: no-bullets + +.. thumbnail:: /_images/Educators_create_course.png + + .. Note:: + :class: dropdown + + The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: + + ``https://your-domain/courses/course-v1:ORGANIZATION+COURSE_NUMBER+COURSE_RUN/`` + + So take care when entering values for the new course. + +1. Open Studio at the URL provided by your administrator. + +2. Click :guilabel:`New Course`. The Create a New Course screen opens. + +3. Enter information for the new course: + + * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. + + * **Organization**: Your school or organization. This value becomes part of the course URL and cannot be changed. You can override how the organization is displayed to learners in Advanced Settings. + + * **Course Number**: The unique number that identifies your course. Note: This value becomes part of the course URL and cannot be changed. No spaces or special characters are allowed. + + * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. + +4. Click :guilabel:`Create`. + +You are then taken to the empty Outline page in Studio. \ No newline at end of file From 22beb5b973294f994c53168f38cb40613693f000 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Mon, 16 Dec 2024 16:55:16 -0300 Subject: [PATCH 03/10] adjusting toc --- source/educators/how-tos/create_course.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst index 130decd8f..ae7eab514 100644 --- a/source/educators/how-tos/create_course.rst +++ b/source/educators/how-tos/create_course.rst @@ -5,9 +5,9 @@ Create a New Course Screen .. tags:: educator, quickstart -.. contents:: Contents - :depth: 1 - :local: no-bullets +.. contents:: Steps + :local: + :class: no-bullets .. thumbnail:: /_images/Educators_create_course.png From c54fbf61cecaccf1d7721c3fb1c114505925c09a Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Tue, 17 Dec 2024 10:36:25 -0300 Subject: [PATCH 04/10] adjusting navigation --- source/educators/navigation/creating_course.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/navigation/creating_course.rst b/source/educators/navigation/creating_course.rst index 408d5143b..2d7d48992 100644 --- a/source/educators/navigation/creating_course.rst +++ b/source/educators/navigation/creating_course.rst @@ -62,7 +62,7 @@ Create a New Course ../references/workflow.rst ../concepts/open_edx_platform/outline_studio_lms.rst ../how-tos/set_up_course/creating_new_course.rst - ../how-tos/create_course.rst + ../quickstarts/create_course.rst ../how-tos/create_course_about_page.rst ../references/course_development/understanding_course_outline.rst ../references/course_development/add_edit_in_outline.rst From 7d783f198ee95025b23c477e6fb30b5f563dbff4 Mon Sep 17 00:00:00 2001 From: jesgreco <74380129+jesgreco@users.noreply.github.com> Date: Tue, 17 Dec 2024 10:38:52 -0300 Subject: [PATCH 05/10] Delete source/educators/how-tos/create_course.rst --- source/educators/how-tos/create_course.rst | 39 ---------------------- 1 file changed, 39 deletions(-) delete mode 100644 source/educators/how-tos/create_course.rst diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst deleted file mode 100644 index ae7eab514..000000000 --- a/source/educators/how-tos/create_course.rst +++ /dev/null @@ -1,39 +0,0 @@ - -########################## -Create a New Course Screen -########################## - -.. tags:: educator, quickstart - -.. contents:: Steps - :local: - :class: no-bullets - -.. thumbnail:: /_images/Educators_create_course.png - - .. Note:: - :class: dropdown - - The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: - - ``https://your-domain/courses/course-v1:ORGANIZATION+COURSE_NUMBER+COURSE_RUN/`` - - So take care when entering values for the new course. - -1. Open Studio at the URL provided by your administrator. - -2. Click :guilabel:`New Course`. The Create a New Course screen opens. - -3. Enter information for the new course: - - * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. - - * **Organization**: Your school or organization. This value becomes part of the course URL and cannot be changed. You can override how the organization is displayed to learners in Advanced Settings. - - * **Course Number**: The unique number that identifies your course. Note: This value becomes part of the course URL and cannot be changed. No spaces or special characters are allowed. - - * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. - -4. Click :guilabel:`Create`. - -You are then taken to the empty Outline page in Studio. \ No newline at end of file From 91efc3e3ab12848afb884211a67e97726381cf1a Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Wed, 18 Dec 2024 09:56:06 -0300 Subject: [PATCH 06/10] fixing error_create_course.rst --- source/educators/quickstarts/create_course.rst | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/source/educators/quickstarts/create_course.rst b/source/educators/quickstarts/create_course.rst index 4c31f7db3..cd42d2246 100644 --- a/source/educators/quickstarts/create_course.rst +++ b/source/educators/quickstarts/create_course.rst @@ -7,8 +7,8 @@ Create a New Course Screen .. thumbnail:: /_images/Educators_create_course.png - .. Note:: - :class: dropdown +.. Note:: + :class: dropdown The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: @@ -16,11 +16,11 @@ Create a New Course Screen So take care when entering values for the new course. -1. Open Studio at the URL provided by your administrator. +#. Open Studio at the URL provided by your administrator. -2. Click :guilabel:`New Course`. The Create a New Course screen opens. +#. Click :guilabel:`New Course`. The Create a New Course screen opens. -3. Enter information for the new course: +#. Enter information for the new course: * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. @@ -30,9 +30,6 @@ Create a New Course Screen * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. -4. Click :guilabel:`Create`. - -You are then taken to the empty Outline page in Studio. - - +#. Click :guilabel:`Create`. +You are then taken to the empty Outline page in Studio. \ No newline at end of file From 1bdc0c41ea6e3dd71449685a56af16a226ad747b Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Wed, 18 Dec 2024 13:21:35 -0300 Subject: [PATCH 07/10] adding create_course.rst to howto folder --- source/educators/how-tos/create_course.rst | 34 ++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 source/educators/how-tos/create_course.rst diff --git a/source/educators/how-tos/create_course.rst b/source/educators/how-tos/create_course.rst new file mode 100644 index 000000000..2ce1f6a1e --- /dev/null +++ b/source/educators/how-tos/create_course.rst @@ -0,0 +1,34 @@ +########################## +Create a New Course Screen +########################## + +.. tags:: educator, quickstart + +.. thumbnail:: /_images/Educators_create_course.png + +.. Note:: + :class: dropdown + + The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: + + ``https://your-domain/courses/course-v1:ORGANIZATION+COURSE_NUMBER+COURSE_RUN/`` + + So take care when entering values for the new course. + +#. Open Studio at the URL provided by your administrator. + +#. Click :guilabel:`New Course`. The Create a New Course screen opens. + +#. Enter information for the new course: + + * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. + + * **Organization**: Your school or organization. This value becomes part of the course URL and cannot be changed. You can override how the organization is displayed to learners in Advanced Settings. + + * **Course Number**: The unique number that identifies your course. Note: This value becomes part of the course URL and cannot be changed. No spaces or special characters are allowed. + + * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. + +#. Click :guilabel:`Create`. + +You are then taken to the empty Outline page in Studio. \ No newline at end of file From 09d775dbf395ab26752d147aa4c014b9f5fc14b1 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Wed, 18 Dec 2024 13:22:54 -0300 Subject: [PATCH 08/10] changing reference of create_course.rst --- source/educators/navigation/creating_course.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/educators/navigation/creating_course.rst b/source/educators/navigation/creating_course.rst index 2d7d48992..408d5143b 100644 --- a/source/educators/navigation/creating_course.rst +++ b/source/educators/navigation/creating_course.rst @@ -62,7 +62,7 @@ Create a New Course ../references/workflow.rst ../concepts/open_edx_platform/outline_studio_lms.rst ../how-tos/set_up_course/creating_new_course.rst - ../quickstarts/create_course.rst + ../how-tos/create_course.rst ../how-tos/create_course_about_page.rst ../references/course_development/understanding_course_outline.rst ../references/course_development/add_edit_in_outline.rst From 1071c262fc0c7cd684a5d2f4eac34d08e9f67ddc Mon Sep 17 00:00:00 2001 From: jesgreco <74380129+jesgreco@users.noreply.github.com> Date: Wed, 18 Dec 2024 13:26:44 -0300 Subject: [PATCH 09/10] Delete source/educators/quickstarts/create_course.rst --- .../educators/quickstarts/create_course.rst | 35 ------------------- 1 file changed, 35 deletions(-) delete mode 100644 source/educators/quickstarts/create_course.rst diff --git a/source/educators/quickstarts/create_course.rst b/source/educators/quickstarts/create_course.rst deleted file mode 100644 index cd42d2246..000000000 --- a/source/educators/quickstarts/create_course.rst +++ /dev/null @@ -1,35 +0,0 @@ - -########################## -Create a New Course Screen -########################## - -.. tags:: educator, quickstart - -.. thumbnail:: /_images/Educators_create_course.png - -.. Note:: - :class: dropdown - - The Organization, Course Number, and Course run values you enter when creating a course are part of the learner-visible course URL and cannot be changed. The base URL for the new course is in the format: - - ``https://your-domain/courses/course-v1:ORGANIZATION+COURSE_NUMBER+COURSE_RUN/`` - - So take care when entering values for the new course. - -#. Open Studio at the URL provided by your administrator. - -#. Click :guilabel:`New Course`. The Create a New Course screen opens. - -#. Enter information for the new course: - - * **Course Name**: The public display name of the course. You can override the name later in the Advanced Settings. - - * **Organization**: Your school or organization. This value becomes part of the course URL and cannot be changed. You can override how the organization is displayed to learners in Advanced Settings. - - * **Course Number**: The unique number that identifies your course. Note: This value becomes part of the course URL and cannot be changed. No spaces or special characters are allowed. - - * **Course Run**: The term or unique run of the course. This value part of your course URL, so no spaces or special characters are allowed and it cannot be changed. - -#. Click :guilabel:`Create`. - -You are then taken to the empty Outline page in Studio. \ No newline at end of file From 58792dfa10550e33b400f3ff55e61e4a91830ee3 Mon Sep 17 00:00:00 2001 From: Jesica Greco Date: Thu, 19 Dec 2024 12:51:05 -0300 Subject: [PATCH 10/10] adding target to create_course.rst --- source/educators/quickstarts/create_course.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/educators/quickstarts/create_course.rst b/source/educators/quickstarts/create_course.rst index cd42d2246..580853544 100644 --- a/source/educators/quickstarts/create_course.rst +++ b/source/educators/quickstarts/create_course.rst @@ -1,3 +1,5 @@ +.. _Create a New Course Screen + ########################## Create a New Course Screen