docs: add developer glossary to getting_started section - #15013
Merged
Conversation
Contributor
📖 Documentation Preview📄 2 changed documentation pagesLast updated: Tue, 26 May 2026 20:22:08 GMT |
Converts the concepts glossary from tutorials/nextcloud-dev-course/ into a properly formatted RST page at developer_manual/getting_started/glossary.rst. Adds it as the first entry in the getting_started toctree so new contributors find it before diving into environment setup. Improvements over the source document: - Full RST conversion: code-block directives, list-table, :command: roles - Added .. contents:: local TOC for easy navigation - Added .. _csrf: and .. _ocs-api: anchors for cross-referencing - Replaced broken cross-manual :doc: ref with an external URL - Expanded several entries for clarity and consistency with docs style - Removed tutorial-specific environment instructions where not appropriate AI-Assisted-By: Claude Sonnet 4.6 <noreply@anthropic.com> Signed-off-by: Anna Larch <anna@nextcloud.com>
miaulalala
force-pushed
the
feature/developer-glossary
branch
from
May 26, 2026 20:13
ab497b6 to
9f39759
Compare
Contributor
Author
|
/backport to stable34 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
☑️ Resolves
No linked issue — this is a new page ported from the Nextcloud dev course tutorial materials.
📝 Summary
Adds a developer glossary at
developer_manual/getting_started/glossary.rst, placed as the first entry in the Getting Started toctree so new contributors see it before the dev environment and coding standards pages.The source was
tutorials/nextcloud-dev-course/before-you-start.md, a concepts reference written for an introductory dev course. Changes from the source:.. code-block::,.. list-table::,:command:roles, local.. contents::TOC.. _csrf:and.. _ocs-api:anchors for cross-referencing from other pagessphinx-lintreports no problems🖼️ Screenshots
No visual/layout changes — new content page only.
✅ Checklist
codespellor similar and addressed any spelling issues