nextcloud / nextcloud/academy

Self-test both beginner tracks end to end

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

Self-test both beginner tracks end to end: follow every module as a reader would, in a clean environment, and fix what breaks.

Both tracks are complete and have had beta-tester feedback applied, but a full pass by someone following the instructions literally has not been recorded as done.

Why it is worth the time

Every issue found this way is one a real reader would have hit. The known content issues (#17, #18, #19, #21) all came from this kind of pass rather than from reading the content.

Scope

  • PHP beginner, all 8 modules, from a fresh environment
  • ExApp beginner, all 8 modules, same
  • At least one run via Codespaces, since that path is the least exercised (see #19)

File what turns up as separate issues rather than fixing silently, so the coverage is visible.

Done when

Both tracks have been walked start to finish and the findings are filed.

Raised 2026-06-17.

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 the PHP beginner and ExApp beginner tracks, following all 8 modules in each from a clean environment. Run at least one complete track through Codespaces, paying attention to the path discussed in #19. File each problem as a separate issue; done means both tracks have been completed and all findings are recorded.

Written by the indexing model from the issue text.

Assessment

Tech stack
github, php
Domain
documentation, testing-qa
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
65/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.