Fix doc build failures that were caused by Python module import failures. Also fix broken cross references. https://openedx.atlassian.net/browse/DOC-2478

docs/en_us/platform_api/source/conf.py

@@ -13,55 +13,35 @@ MOCK_MODULES = [
     'lxml',
     'requests',
     'xblock',
-    'fields',
     'xblock.fields',
-    'frament',
     'xblock.fragment',
     'webob',
-    'multidict',
     'webob.multidict',
-    'core',
     'xblock.core',
-    'runtime',
     'xblock.runtime',
     'sortedcontainers',
     'contracts',
-    'plugin',
     'xblock.plugin',
     'opaque_keys.edx.asides',
-    'asides',
     'dogstats_wrapper',
     'fs',
     'fs.errors',
     'edxmako',
     'edxmako.shortcuts',
-    'shortcuts',
     'crum',
     'opaque_keys.edx.locator',
-    'LibraryLocator',
-    'Location',
     'ipware',
-    'ip',
     'ipware.ip',
-    'get_ip',
     'pygeoip',
     'ipaddr',
     'django_countries',
-    'fields',
     'django_countries.fields',
     'opaque_keys',
     'opaque_keys.edx',
     'opaque_keys.edx.keys',
-    'CourseKey',
-    'UsageKey',
-    'BlockTypeKey',
     'opaque_keys.edx.locations',
-    'SlashSeparatedCourseKey',
-    'Locator',
     'courseware',
-    'access',
     'courseware.access',
-    'is_mobile_available_for_user',
     'courseware.model_data',
     'courseware.module_render',
     'courseware.views',
@@ -81,9 +61,7 @@ MOCK_MODULES = [
     'analytics',
     'courseware.courses',
     'django.contrib.staticfiles',
-    'storage',
     'django.contrib.staticfiles.storage',
-    'content',
     'xmodule.contentstore',
     'xmodule.contentstore.content',
     'xblock.exceptions',
@@ -98,18 +76,13 @@ MOCK_MODULES = [
     'social.apps.django_app',
     'social.backends',
     'mako',
-    'exceptions',
     'mako.exceptions',
     'boto',
-    'exception',
     'boto.exception',
     'PIL',
     'reportlab',
-    'lib',
     'reportlab.lib',
     'pdfgen',
-    'canvas',
-    'pdfgen',
     'pdfgen.canvas',
     'reportlab.pdfgen',
     'reportlab.pdfgen.canvas',
@@ -118,9 +91,6 @@ MOCK_MODULES = [
     'reportlab.lib.styles',
     'reportlab.platypus',
     'reportlab.platypus.tables',
-    'boto',
-    's3',
-    'connection',
     'boto.s3',
     'boto.s3.connection',
     'boto.s3.key',
@@ -128,13 +98,9 @@ MOCK_MODULES = [
     'Crypto.Cipher',
     'Crypto.PublicKey',
     'openid',
-    'store',
-    'interface',
     'openid.store',
-    'store.interface',
     'openid.store.interface',
     'external_auth.views',
-    'html_to_text',
     'mail_utils',
     'ratelimitbackend.backends',
     'social.apps.django_app.default',
@@ -166,35 +132,23 @@ MOCK_MODULES = [
     'student.roles',
     'embargo.models',
     'xmodule.vertical_block',
-    'vertical_block',
-    'errors',
-    'UserNotFound',
-    'UserNotAuthorized',
-    'AccountUpdateError',
-    'AccountValidationError',
-    'transaction',
-    'parsers',
-    'MergePatchParser',
-    'get_account_settings',
-    'update_account_settings',
-    'serializers',
-    'profile_images.images',
     'xmodule.course_module',
     'user_api.accounts.api',
     'user_api.accounts.serializers',
     'edx_rest_api_client',
-    'client',
     'edx_rest_api_client.client',
     'edx_rest_api_client.exceptions',
     'student.auth',
     'ccx_keys',
     'ccx_keys.locator',
     'user_api.preferences.api',
-    'rest_framework_oauth.authentication'
+    'rest_framework_oauth.authentication',
+    'certificates.api',
+    'courseware.date_summary',
 ]
 
 for mod_name in MOCK_MODULES:
-    sys.modules[mod_name] = mock.Mock(class_that_is_extended=object)
+    sys.modules[mod_name] = mock.Mock()
 
 if "DJANGO_SETTINGS_MODULE" not in os.environ:
     docs_path = os.getcwd()