This page is slowly being moved to github issues.
See https://github.com/openedx/edx-toggles/issues/296 for completing the transition and archiving this page.
See https://docs.google.com/spreadsheets/d/1PUq0DkNJLp0SuY1Jt38n_USy1IExlACI2yZt0ZmhD8g/edit#gid=0 for initial prioritization.
(HIGH) DEPR improvement ideas:
Add deprecation ticket to a separate annotation for convenient filtering out during future reviews
Check toggle_implementation annotation matches actual implementation class used when possible.
Note: examples of manually corrected errors.
No linting exists to ensure settings are annotated.
Needs brainstorming if we think this would be important.
No linting exists to ensure ConfigModels with booleans are annotated.
Include more annotated settings in RTD documentation.
For settings toggles we currently only capture annotations if they are in lms/envs/common.py or cms/envs/common.py
We have settings annotations where the default and annotation live outside of those two files within edx-platform. See an example annotation.
We will have annotations where the default live in an external library (edx-when, or other edx owned libraries)
See some discussion and disagreements in Slack in #external-openedx-toggles-and-settings.
Discovery: How can we capture settings toggles not documented in lms/envs/common.py or cms/envs/common.py but are still in the edx-platform repo
Either a POC that captures settings in other places or an ADR to guide us on where these docs should live.
Discovery: How do we collect annotations from libraries installed in edx-platform?
Allow for formatting in annotations, rather than having everything be plain-text.
Consider allowing arbitrary formatted rST.
Remove pylint disable pragmas from annotation output.
All, or just line-too-long?
See examples (including amnesty).
Reporting on suspicious toggle state data
Bad data like waffle names with leading or trailing spaces in the database.
Potentially orphaned data (data with no annotation and no toggle definition)
Toggle State Report may be simplest location, using a new column
Replace or improve ExperimentWaffleFlag
See Learning MFE toggle feedback
The following toggles and settings tooling potential tasks around toggles and settings tooling, was generated while working on https://openedx.atlassian.net/wiki/spaces/COMM/pages/1596358943, https://openedx.atlassian.net/wiki/spaces/AC/pages/2248409171, and earlier work from the Arch-BOM team.