Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Feature: Organize documentation topics in beginner-friendly learning order

Aberta
#2,611 0 comentários 1 reação 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Funcionalidade
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada

Direção de pesquisa

A issue não nomeia arquivos, testes ou pontos de entrada. Comece localizando como os tópicos da documentação são ordenados atualmente e como a visualização pode ser alternada; considera-se concluído quando existe uma ordenação opcional focada no aprendizado, enquanto a visualização de referência alfabética permanece disponível, com uma progressão definida como no exemplo em C.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

docs/improvement help wanted

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.

Linguagem predominante
Ruby
Estrelas
39.6k
Forks
2.7k
Merge médio
1d 22h
PRs com merge (30d)
15

Preparar o ambiente

Abrir no Codespaces

Inicia o contêiner de desenvolvimento do projeto no navegador, com a sua própria conta do GitHub.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de freeCodeCamp/devdocs

Todas as issues de freeCodeCamp/devdocs

Issues semelhantes

Mais issues de Ruby

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.