nextcloud / nextcloud/academy

Write the shared federation capstone lab

Open
#14 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

Part of the content gap. The federation capstone lab has no content.

content/shared/ contains only setup.md. The manifest declares shared.capstone as federation-lab — "spin up both Pinboard implementations and federate them", attemptable after either track's Advanced federation module — and both php-a-03 and ex-a-03 are flagged federation_capstone: true.

This is the point where the two tracks converge, so it is the payoff for the whole course structure.

Depends on

The advanced modules of both tracks, at least the federation ones.

Note

The manifest's capstone entry lists downloads pointing at federation starting-point repos (e.g. pinboard-php-federation). Those repos need to exist — check before writing instructions that reference them. Related: the pinboard-python scaffold repo does not exist yet either.

Done when

The lab is written, and every repo or download it references actually exists.

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 by reading content/shared/setup.md and the manifest entry for shared.capstone, then review the advanced federation modules in both tracks. Check that every federation starting-point repository named in the manifest downloads exists before referencing it. Done means the capstone lab is written and all repositories or downloads it references are available.

Written by the indexing model from the issue text.

Assessment

Tech stack
php, python
Domain
content, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.