nextcloud / nextcloud/academy

Idea: per-release refresher modules

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

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
2
Forks
1
Avg merge
1d 2h
Merged PRs (30d)
7

Description

Idea from 2026-06-17, recorded so it is not lost: per-release refresher modules.

Nextcloud app development changes every release — APIs get deprecated, @nextcloud/vue has breaking changes, the test suite shifts. A course written once is stale within two releases, and the content already carries version-specific notes (NC34 specifics, "jQuery and old globals are gone", Vite replacing Webpack in 2025).

The idea

A short module per release covering what changed for app developers, sourced from:

  • the Nextcloud developer documentation changelog
  • @nextcloud/vue changelogs
  • test suite release notes

Open questions

  • Does this scale, or does it become a maintenance burden that outlives the motivation to write it?
  • Is it better served by a "what changed" section in each release's docs rather than course modules?
  • Who owns it — this is a recurring commitment, unlike every other issue here

Not scoped further. Worth a decision before it is worth work.

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

Review the Nextcloud developer documentation changelog, @nextcloud/vue changelogs, and test suite release notes to assess the proposed sources. First resolve whether recurring modules or per-release documentation sections are sustainable, then define ownership and a repeatable scope; done means an agreed format, responsibility, and initial release plan.

Written by the indexing model from the issue text.

Assessment

Tech stack
vite, webpack
Domain
documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.