Add a table of contents page on every documentation.

Open
#2,683 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
30/100
Issue type
Feature
Clarity
Needs clarification
Activity status
Active
Domain
documentation

Research direction

No files, tests, or entry points are named. Start by reading the README vision and reviewing how the project's language and framework documentation is structured; the work is done when every documentation has an agreed table of contents covering introductory material through functional or class references.

Written by the indexing model from the issue text.

Description

feature

Feature request

I am suggesting a table of contents on each documentation.

Summary

The table of contents should start with entry into the language or framework, then functional or class reference of it.

This will make sure that everyone getting started on a language has a clear flow of knowledge from easy to expert, then for the experts, functional reference list will be a plus

Examples

lets say we want to create a table of contents for html:

Table of Contents: HTML
What is html ........................................................ 1
Evolution of HTML ............................................ 2
some feature ....................................................... n

Functional References
function one ......................................................... n +2

Dominant language
Ruby
Stars
39.5k
Forks
2.6k
Avg merge
4d 32m
Merged PRs (30d)
13

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.

More from freeCodeCamp/devdocs

All issues in freeCodeCamp/devdocs

Similar issues

More Ruby issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.