openedx / openedx/frontend-plugin-framework

Docs: Create ADR for default content versioning

Open
#112 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
13
Forks
28
PR merge metrics
No merged PRs in 30d

Description

We need a way to communicate notable changes to the default content of a slot. This should cover changes that aren't breaking changes to the API of a slot (no changes to plugin props or location on page), so plugins would still work, but any plugins that rely on the default content might need to be tweaked to account for the default content changes.

A good example of this comes from https://github.com/openedx/frontend-app-learning/pull/1713/ where slots are moving from having something as default content to having nothing. Any plugins that replace the default content entirely will continue to work without any changes, but any plugins designed around wrapping the default content would instead be wrapping nothing.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with this issue and the linked frontend-app-learning PR #1713 to compare default-content changes with plugin API changes. Draft an ADR that defines how non-breaking default content changes are communicated, including the distinction between plugins that replace content and those that wrap it; it is done when that guidance is documented and reviewable.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.