Merge pull request #27222 from edx/robrap/ARCHBOM-1721-toggle-doc-cleanup
ARCHBOM-1721: docs: update toggle docs
This commit is contained in:
@@ -12,19 +12,29 @@ from openedx.core.djangoapps.waffle_utils import CourseWaffleFlag
|
||||
WAFFLE_NAMESPACE = 'studio'
|
||||
|
||||
# Switches
|
||||
# TODO: Replace with WaffleSwitch(). See waffle() docstring.
|
||||
ENABLE_ACCESSIBILITY_POLICY_PAGE = 'enable_policy_page'
|
||||
|
||||
|
||||
def waffle():
|
||||
"""
|
||||
Returns the namespaced, cached, audited Waffle Switch class for Studio pages.
|
||||
Deprecated: Returns the namespaced, cached, audited Waffle Switch class for Studio pages.
|
||||
|
||||
IMPORTANT: Do NOT copy this pattern and do NOT use this to reference new switches.
|
||||
Instead, replace the string constant above with the actual switch instance.
|
||||
For example::
|
||||
|
||||
ENABLE_ACCESSIBILITY_POLICY_PAGE = WaffleSwitch(f'{WAFFLE_NAMESPACE}.enable_policy_page')
|
||||
"""
|
||||
return LegacyWaffleSwitchNamespace(name=WAFFLE_NAMESPACE, log_prefix='Studio: ')
|
||||
|
||||
|
||||
def waffle_flags():
|
||||
"""
|
||||
Returns the namespaced, cached, audited Waffle Flag class for Studio pages.
|
||||
Deprecated: Returns the namespaced, cached, audited Waffle Flag class for Studio pages.
|
||||
|
||||
IMPORTANT: Do NOT copy this pattern and do NOT use this to reference new flags.
|
||||
See waffle() docstring for more details.
|
||||
"""
|
||||
return LegacyWaffleFlagNamespace(name=WAFFLE_NAMESPACE, log_prefix='Studio: ')
|
||||
|
||||
|
||||
@@ -22,15 +22,12 @@ EXPORT_GIT = SettingDictToggle(
|
||||
WAFFLE_NAMESPACE = 'contentstore'
|
||||
WAFFLE_FLAG_NAMESPACE = LegacyWaffleFlagNamespace(name=WAFFLE_NAMESPACE, log_prefix='Contentstore: ')
|
||||
|
||||
# Waffle flag to split library to new view.
|
||||
# .. toggle_name: split_library_on_studio_dashboard
|
||||
# .. toggle_implementation: WaffleFlag
|
||||
# .. toggle_default: False
|
||||
# .. toggle_description: Studio dashboard
|
||||
# .. toggle_description: Enables data new view for library on studio dashboard.
|
||||
# .. toggle_use_cases: open_edx
|
||||
# .. toggle_creation_date: 2020-07-8
|
||||
# .. toggle_target_removal_date: None
|
||||
# .. toggle_warnings: ??
|
||||
# .. toggle_tickets: TNL-7536
|
||||
SPLIT_LIBRARY_ON_DASHBOARD = LegacyWaffleFlag(
|
||||
waffle_namespace=LegacyWaffleFlagNamespace(name=WAFFLE_NAMESPACE),
|
||||
@@ -38,15 +35,13 @@ SPLIT_LIBRARY_ON_DASHBOARD = LegacyWaffleFlag(
|
||||
module_name=__name__
|
||||
)
|
||||
|
||||
# Waffle flag to enable olx validation during course import.
|
||||
# .. toggle_name: course_import_olx_validation
|
||||
# .. toggle_implementation: WaffleFlag
|
||||
# .. toggle_default: False
|
||||
# .. toggle_description: Studio Import
|
||||
# .. toggle_description: Enables olx validation during course import.
|
||||
# .. toggle_use_cases: open_edx
|
||||
# .. toggle_creation_date: 2021-04-01
|
||||
# .. toggle_target_removal_date: 2021-05-01
|
||||
# .. toggle_warnings: ??
|
||||
# .. toggle_tickets: TNL-8151
|
||||
COURSE_IMPORT_OLX_VALIDATION = LegacyWaffleFlag(
|
||||
waffle_namespace=LegacyWaffleFlagNamespace(name=WAFFLE_NAMESPACE),
|
||||
|
||||
Reference in New Issue
Block a user