Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: ADR to address Github project changes #193

Merged
merged 3 commits into from
Sep 30, 2024
Merged

Conversation

bmtcril
Copy link
Contributor

@bmtcril bmtcril commented Feb 20, 2024

No description provided.

Copy link
Contributor

@pomegranited pomegranited left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💯 for this change! I left some requests and nits.

docs/decisions/0014_project_structure_update.rst Outdated Show resolved Hide resolved
Consequences
************

* `openedx-event-sink-clickhouse` and `platform_plugin_superset` will be consolidated into `openedx-aspects`_ and re-licensed to Apache 2. `openedx-event-sink-clickhouse` will be archived under the `openedx-unsupported`_ Github organization.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we see a sketch of the proposed file structure like we did for https://docsopenedxorg--193.org.readthedocs.build/projects/openedx-aspects/en/193/decisions/0008_project_structure.html#decisions , so we know where new plugins will live?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One impact of this change which hasn't been mentioned: openedx-event-sink-clickhouse is currently a hard dependency for Aspects, but platform_plugin_superset is not. By consolidating both of those repos into this one, we've made openedx-aspects a hard dependency for Aspects, which means platform_plugin_superset gets installed whether users want it or not.

For optional plugins like this one, we should specify what convention will we use to enable/disable them in the LMS.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The LMS integration works by using a filter which is configured using the following setting:

     OPEN_EDX_FILTERS_CONFIG = {
       "org.openedx.learning.instructor.dashboard.render.started.v1": {
         "fail_silently": False,
         "pipeline": [
           "platform_plugin_superset.extensions.filters.AddSupersetTab",
         ]
       },
     }

We need to make sure that tutor-contrib-aspects injects it into the settings without damaging what users have configured in their installations and make sure there is an up-to-date troubleshooting guide for Aspects

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated to include the fact that this will just be a Django cookiecutter structure, which I don't think merits copying into this doc, but let me know if you feel differently. Also updated to include details on configuration and how each part can be turned on or off. Should be ready for re-review!

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated to include the fact that this will just be a Django cookiecutter structure, which I don't think merits copying into this doc, but let me know if you feel differently.

Agreed.

Also updated to include details on configuration and how each part can be turned on or off.

Thank you! LGTM.

Copy link
Member

@felipemontoya felipemontoya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me. As the legal representative of edunext I approve the change of license as well.

@felipemontoya
Copy link
Member

Does this mean we need to re-license https://github.com/eduNEXT/platform-plugin-superset/ to match the apache2 ?

@bmtcril
Copy link
Contributor Author

bmtcril commented Feb 21, 2024

@felipemontoya I think that's a legal question, that we're not qualified to answer unfortunately. I've asked Axim legal whether we need anything else from you to accept this contribution, I'll let you know when I hear back.

Copy link
Contributor

@pomegranited pomegranited left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

  • I tested this by reading the rendered ADR.

@bmtcril bmtcril force-pushed the bmtcril/update_repo_scheme branch from e5af431 to 5507844 Compare September 30, 2024 14:19
@bmtcril bmtcril merged commit 3a431c1 into main Sep 30, 2024
3 checks passed
@bmtcril bmtcril deleted the bmtcril/update_repo_scheme branch September 30, 2024 14:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants