Feature: Organize documentation topics in beginner-friendly learning order
まだ誰も着手していません。
評価
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 初心者へのやさしさ
- 25/100
- issue の種類
- 機能追加
- 明瞭さ
- 説明が足りない
- 活発さ
- 停滞
- 領域
- content, documentation
調査の方向性
この issue では、ファイル、テスト、エントリーポイントが指定されていません。まず、ドキュメントのトピックが現在どのように並べ替えられているか、またビューをどのように切り替えられるかを確認してください。C の例のように定義された進行順序を持つ、学習に重点を置いた任意の順序が存在し、アルファベット順のリファレンスビューも引き続き利用できれば完了です。
索引モデルが issue の本文から書いたものです。
説明
Feature request
I have checked existing issues and labels, and this feature appears to be frequent among the learners and followers. We follow your developed curriculum, and we do support it, but almost everybody finds it frustrating to navigate and search for each topic based on the standard order/structure.
Summary
Currently, all documentation topics are sorted alphabetically, which creates a poor learning experience for beginners and anyone studying a new technology for the first time. Alphabetical ordering places advanced concepts before fundamental ones (e.g., "Algorithm" appears before basic syntax in C documentation), making it difficult to follow a logical learning progression.
This feature should add an optional "Learning Paths" mode that organizes documentation topics in a structured, beginner-friendly order. Users could toggle between the current alphabetical view (maintained for reference use) and learning-focused view that follows natural learning sequences from basic to advanced concepts.
This enhancement would transform DevDocs from purely a reference tool into a more comprehensive learning platform while maintaining its core strengths, making it especially valuable for students, career changers, and developers learning new technologies.
Examples
In C documents (as well as other documents with similar issue)
Alphabetical sorting: Algorithm → Atomic → Basic Syntax → Variables
Ideal learning order: Basic Syntax → Variables → Functions → Algorithm → Advanced Topics
Thank you for your attention to this matter.
- 主要言語
- Ruby
- スター
- 39.5k
- フォーク
- 2.6k
- 平均マージ
- 2日 9時間
- マージ済み PR(30日)
- 13
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
freeCodeCamp/devdocs のほかの issue
-
docs/improvement
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
freeCodeCamp/devdocs#1989 · コメント 4 件 · リアクション 4 件 ·
-
難易度 5/5 1週間以上 初心者へのやさしさ 20/100
freeCodeCamp/devdocs#2731 ·
-
feature
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
freeCodeCamp/devdocs#2712 ·
-
feature
難易度 5/5 1週間以上 初心者へのやさしさ 30/100
freeCodeCamp/devdocs#2683 · コメント 1 件 ·
-
feature
難易度 4/5 3〜5日 初心者へのやさしさ 45/100
freeCodeCamp/devdocs#2673 ·
freeCodeCamp/devdocs の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 65/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100
googleapis/google-api-ruby-client#28001 · リアクション 5 件 ·
-
難易度 2/5 1〜3時間 初心者へのやさしさ 75/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 70/100