Migrate installing, configuring, and running guide

Author: sarina

source/community/release_notes/dogwood.rst

@@ -117,7 +117,7 @@ enhancement also gives system administrators the ability to configure a list of
 file types that learners cannot upload.
 
 For more information, see
-Configuring ORA2 to Prohibit Submission of File Types.
+:ref:`Configuring ORA2 to Prohibit Submission of File Types`.
 
 Certificates
 ============

source/developers/references/developer_guide/links.rst

@@ -101,4 +101,4 @@ back to you with questions.
 .. _Open edX Release Planning: https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845/Open+edX+Release+Planning
 
 
-.. include:: ../links.rst
+.. include:: /links.txt

source/developers/references/developer_guide/process/code-considerations.rst

@@ -62,4 +62,4 @@ link to a WIP pull request in any discussion threads you start.
 .. _Open edX Product Working Group: https://openedx.atlassian.net/wiki/spaces/COMM/pages/3449028609/Product+Working+Group
 .. _Product Roadmap: https://github.com/orgs/openedx/projects/4
 
-.. include:: ../links.rst
+.. include:: /links.txt

source/developers/references/developer_guide/process/contributor.rst

@@ -35,4 +35,4 @@ questions or concerns.
 * :ref:`Accessibility Guidelines`
 * :ref:`analytics`
 
-.. include:: ../links.rst
+.. include:: /links.txt

source/developers/references/developer_guide/process/overview.rst

@@ -98,4 +98,4 @@ changes.
 .. _.github repo: https://github.com/openedx/.github/tree/master/.github/workflows
 .. _fix Transifex resource names: https://github.com/openedx/openedx-translations/blob/main/.github/workflows/fix-transifex-resource-names.yml
 .. _workflow dispatch: https://github.com/openedx/openedx-translations/blob/cf313a06ebf8c3a792e67174dfcba7607da2d61f/.github/workflows/fix-transifex-resource-names.yml#L5-L13
-.. include:: ../links.rst
+.. include:: /links.txt

source/developers/references/developer_guide/testing/github-actions.rst

@@ -97,5 +97,6 @@ PRs, and follow them to be notified of when the fix has been applied (and then
 do the rebase). You could even try submitting a PR yourself to fix the failing
 tests!
 
-.. _Open edX Forums: https://discuss.openedx.org/
 .. _openedx.org/cla: http://openedx.org/cla
+
+.. include:: /links.txt

source/developers/references/running_pr_tests.rst

@@ -1,3 +1,5 @@
+.. _Documentor's Home:
+
 Open edX Documentors
 ####################
 

source/documentors/index.rst

@@ -693,7 +693,7 @@ you cannot specify these file types.
 
 This set of file name extensions is provided as the default for Open edX
 installations. Open edX system administrators can update this list. For more
-information, see `Configuring ora2 to prohibit submission of file types`_.
+information, see :ref:`Configuring ora2 to prohibit submission of file types`.
 
 .. list-table::
    :widths: 15 75

source/educators/concepts/exercise_tools/about_OpenResponseAssessments.rst

@@ -10,8 +10,8 @@ Configure Certificate Availability and Timing
  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
- `Enable Automatic Certificate Generation`_ and
- `Enable Certificates`_ in *Installing, Configuring, and
+ :ref:`Enable Automatic Certificate Generation` and
+ :ref:`Enable Certificates` in *Installing, Configuring, and
  Running the Open edX Platform*.
 
 The platform can automatically generate certificates for both self-paced courses and
@@ -64,7 +64,7 @@ Allow Learners to Receive Early Certificates
 ********************************************
 
 If the administrator has configured the site correctly (see
-`Enable Automatic Certificate Generation`_ in
+:ref:`Enable Automatic Certificate Generation` in
 *Installing, Configuring, and Running the Open edX Platform*),
 self-paced courses issue certificates to learners as soon as learners
 have completed enough of the course, with a high enough grade, to earn

source/educators/how-tos/configure_certificate_timing.rst

@@ -44,6 +44,8 @@ Bulk Emails
    ../references/communication/compose_email_message.rst 
    ../how-tos/communication/email_task_history_report.rst 
 
+.. _Automatic Emails:
+
 Automatic Emails
 *******************************************************
 

source/educators/navigation/learner_engagement_communication.rst

@@ -6,8 +6,6 @@
 
 .. _VirtualEnvWrapper: http://virtualenvwrapper.readthedocs.io/en/latest
 
-.. _Configuring ORA2 to Prohibit Submission of File Types: https://edx.readthedocs.io/projects/edx-installing-configuring-and-running/en/latest/configuration/ora2/ora2_blacklist.html
-
 .. _edx-platform: https://github.com/openedx/edx-platform
 
 .. _init file: https://github.com/openedx/edx-ora2/blob/a4ce7bb00190d7baff60fc90fb613229565ca7ef/openassessment/fileupload/backends/__init__.py
@@ -174,10 +172,6 @@
 
 .. _app_label: https://docs.djangoproject.com/en/1.8/ref/models/options/#app-label
 
-.. _Enable Certificates: https://edx.readthedocs.io/projects/edx-installing-configuring-and-running/en/latest/configuration/enable_certificates.html
-
-.. _Enable Automatic Certificate Generation: https://edx.readthedocs.io/projects/edx-installing-configuring-and-running/en/latest/configuration/enable_certificates.html#enable-automatic-certificate-generation
-
 .. _Media formats supported by the HTML audio and video elements: https://developer.mozilla.org/en-US/docs/Web/HTML/Supported_media_formats#MP4_H.264_(AAC_or_MP3)
 
 .. _editing object metadata: http://docs.aws.amazon.com/AmazonS3/latest/UG/EditingtheMetadataofanObject.html
@@ -212,10 +206,134 @@
 
 .. _Time and Date Time Zone Converter: http://www.timeanddate.com/worldclock/converter.html
 
-.. _Installing, Configuring, and Running the Open edX Platform: https://edx.readthedocs.io/projects/edx-installing-configuring-and-running/en/latest/index.html
-
 .. _Tree of Math: http://www.onemathematicalcat.org/MathJaxDocumentation/TeXSyntax.htm
 
 .. _MathJax Documentation: http://docs.mathjax.org/en/latest/index.html
 
 .. _Mathematics meta: http://meta.math.stackexchange.com/questions/5020/mathjax-basic-tutorial-and-quick-reference
+
+.. _Open edX Release Schedule: https://openedx.atlassian.net/wiki/spaces/COMM/pages/3613392957/Open+edX+Release+Schedule
+
+.. _Open edX Releases Wiki page: https://openedx.atlassian.net/wiki/spaces/OEPM/pages/4191191044/Open+edX+Releases+Homepage
+
+.. _The migrate.sh script: https://github.com/openedx/configuration/blob/named-release/dogwood.rc/util/vagrant/migrate.sh
+
+.. _The upgrade.sh script: https://github.com/openedx/configuration/blob/master/util/vagrant/upgrade.sh
+
+.. _forum migration described on the Open edX wiki: https://openedx.atlassian.net/wiki/display/TNL/Migrating+the+Discussion+Forums+to+Support+Teams+Discussion+Filtering
+
+.. _Native Installation to Tutor forum post: https://discuss.openedx.org/t/upgrade-from-native-to-tutor/9252
+
+.. _this second Native to Tutor post: https://discuss.overhang.io/t/migrating-from-native-install-to-tutor-juniper-tutor-10-x/1533
+
+.. _Open edX Installation options: https://openedx.atlassian.net/wiki/x/wwCXAw
+
+.. _Open edX Native 12.04 Installation: https://openedx.atlassian.net/wiki/x/bgCXAw
+
+.. _Legacy Open edX Native Installation: https://openedx.atlassian.net/wiki/x/g4G6C
+
+.. _Koa Open edX Native Installation: https://openedx.atlassian.net/wiki/x/lIJjdQ
+
+.. _Django Forms: https://docs.djangoproject.com/en/1.8/ref/forms/
+
+.. _example CSS file for drag and drop problems: https://github.com/openedx/xblock-drag-and-drop-v2/blob/master/drag_and_drop_v2/public/themes/apros.css
+
+.. _custom_form_app: https://github.com/open-craft/custom-form-app
+
+.. _GitHub: http://github.com
+
+.. _EdX Search: https://github.com/openedx/edx-search/
+
+.. _edX Automated Communication Engine: http://edx-ace.readthedocs.io/en/latest
+
+.. _IMS LTI 1.1 Consumer Launch: http://www.imsglobal.org/developers/LTI/test/v1p1/lms.php
+
+.. _password_policy_validators: https://github.com/openedx/edx-platform/blob/master/common/djangoapps/util/password_policy_validators.py
+
+.. _Python SAML Toolkit: https://github.com/onelogin/python-saml
+
+.. _random and highly secure password: https://github.com/openedx/edx-platform/blob/46d69eba/common/djangoapps/third_party_auth/pipeline.py#L392-L410
+
+.. _OID: https://en.wikipedia.org/wiki/Object_identifier
+
+.. _URN: https://en.wikipedia.org/wiki/Uniform_Resource_Name
+
+.. _eduPersonPrincipalName: https://www.internet2.edu/media/medialibrary/2013/09/04/internet2-mace-dir-eduperson-201203.html#eduPersonPrincipalName
+
+.. _eduPersonEntitlement: https://www.internet2.edu/media/medialibrary/2013/09/04/internet2-mace-dir-eduperson-201203.html#eduPersonEntitlement
+
+.. _eduPerson Object Class Specification: https://www.internet2.edu/media/medialibrary/2013/09/04/internet2-mace-dir-eduperson-201203.html
+
+.. _Google Developers Console: https://console.developers.google.com/project/_/apiui/apis/library
+
+.. _Facebook for Developers: https://developers.facebook.com/apps/?action=create
+
+.. _LinkedIn Developers: https://www.linkedin.com/secure/developer
+
+.. _Microsoft Sign In: https://account.live.com
+
+.. _Azure account creation: https://azure.microsoft.com/en-us/pricing/free-trial
+
+.. _Azure sign in: https://portal.azure.com
+
+.. _AWS template file: https://github.com/openedx/edx-platform/blob/b3462e5b1c3cc45ad8673f3f12e84fa17ffa6b64/lms/envs/aws.py#L586-L596
+
+.. _Font Awesome: http://fortawesome.github.io/Font-Awesome/icons/
+
+.. _Elastic MapReduce: http://aws.amazon.com/elasticmapreduce/
+
+.. _default EC2 role for Amazon EMR: http://docs.aws.amazon.com/ElasticMapReduce/latest/DeveloperGuide/emr-iam-roles-defaultroles.html#emr-iam-roles-defaultec2
+
+.. _Default IAM Roles for Amazon EMR: https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-iam-role-for-ec2.html
+
+.. _a single public subnet: http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Scenario1.html
+
+.. _example configuration scenario: http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_Scenario2.html
+
+.. _Open edX Forums: https://discuss.openedx.org/
+
+.. _submission_mixin.py: https://github.com/openedx/edx-ora2/blob/a4ce7bb00190d7baff60fc90fb613229565ca7ef/openassessment/xblock/submission_mixin.py
+
+.. _official Google instructions: https://developers.google.com/identity/protocols/oauth2
+
+.. _python-social-auth supported backend: http://python-social-auth.readthedocs.io/en/latest/backends/index.html#social-backends
+
+.. _list of python-social-auth backends: https://github.com/omab/python-social-auth/tree/master/social/backends
+
+.. _python-social-auth documentation: http://python-social-auth.readthedocs.io/en/latest/index.html
+
+.. _OAuth backends supported by python-social-auth v0.2.12: http://python-social-auth.readthedocs.io/en/latest/backends/index.html#social-backends
+
+.. _the default value in the aws.py file: https://github.com/openedx/edx-platform/blob/b3462e5b1c3cc45ad8673f3f12e84fa17ffa6b64/lms/envs/aws.py#L586-L596
+
+.. _YouTube Data API v3: https://developers.google.com/youtube/v3/
+
+.. _instructions for obtaining authorization credentials: https://developers.google.com/youtube/registering_an_application
+
+.. _Query string syntax: https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-query-string-query.html#query-string-syntax
+
+.. _Ansible: https://docs.ansible.com/
+
+.. _configuration: https://github.com/openedx/configuration
+
+.. _Virtual Environments: http://docs.python-guide.org/en/latest/dev/virtualenvs/
+
+.. _VirtualEnv Installation: https://virtualenv.pypa.io/en/latest/installation.html
+
+.. _VirtualEnvWrapper: http://virtualenvwrapper.readthedocs.io/en/latest
+
+.. _spot pricing market: http://aws.amazon.com/ec2/purchasing-options/spot-instances/
+
+.. _edX Managing the Full Stack: https://github.com/openedx/configuration/wiki/edX-Managing-the-Full-Stack
+
+.. _edX Enrollment API: https://docs.openedx.org/projects/edx-platform/en/latest/references/lms_apis.html#get--enrollment-v1-course-course_id
+
+.. _edx-analytics-configuration: https://github.com/openedx/edx-analytics-configuration
+
+.. _AWS Command Line Interface: http://aws.amazon.com/cli/
+
+.. _edX Analytics Installation: https://openedx.atlassian.net/wiki/display/OpenOPS/edX+Analytics+Installation
+
+.. _retirement: https://user-retirement-guide.readthedocs.io/en/latest/index.html
+
+.. _AWS Documentation: http://aws.amazon.com/documentation/

source/links.txt

@@ -6,8 +6,7 @@ Getting Help
    If you are unable to find what you need here or need more help than the
    documentation provides, we'd love to hear about it via the :doc:`feedback`.
 
-To get more help we recommend checking out the `Open edX Forums
-<https://discuss.openedx.org>`_. Make sure to search the forums before posting a
+To get more help we recommend checking out the `Open edX Forums`_. Make sure to search the forums before posting a
 new question in case others have had the same question as you.
 
 The community also has a `slack workspace
@@ -20,3 +19,5 @@ responses.
 
    The Open edX community has agreed upon a shared `code of conduct
    <https://openedx.org/code-of-conduct/>`_, please be sure to review it.
+
+.. include:: /links.txt

source/other/getting_help.rst

@@ -3,8 +3,7 @@ Open edX Site Operators
 
 .. note::
 
-   This area is still under active development.  You can find the old
-   documentation here: `Installing, Configuring, and Running the Open edX Platform`_
+   This area is still under active development.
 
    For information about the latest release of the Open edX Platform, you can
    check out the  :doc:`/community/release_notes/index`