nextcloud / nextcloud/academy

M2: check for the skeleton reference table and apps-extra placement

Open Beginner friendly
#21 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

Two possible gaps in Module 2 (PHP beginner, app anatomy), flagged when the older tutorial library was reviewed against the course on 2026-06-11. Both need confirming against the current content before doing any work — they may already be covered.

1. Skeleton file/folder reference table

Tutorial 2 in course/files/tutorials/ has a table covering every file in the app skeleton with its purpose. Good reference material at exactly the point a learner is staring at an unfamiliar directory tree.

2. Per-environment apps-extra placement

The source tutorial explains where to put the app for each environment — local Docker, Windows file explorer, Codespaces. content/shared/setup.md mentions the apps-extra/pinboard/ path, so check whether M2 needs it too or can simply reference the setup module.

Done when

Either both are present in M2, or it is recorded that they are covered elsewhere.

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 current Module 2 content and compare it with course/files/tutorials/ for the skeleton file/folder reference table. Check content/shared/setup.md and the M2 material for the per-environment apps-extra placement, including local Docker, Windows file explorer, and Codespaces. Done means both topics are present in M2 or their coverage elsewhere is recorded.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, php
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.