Skip to content

Retain original order of the content in the documentation #953

Open

Description

The content in the documentation is ordered alphabetically which is good but it can very helpful for beginners if it's ordered in the official documentation order. It will make it super easy for beginners to get started with a language or framework using devdocs. Here is an example from laravel 5.6 documentation:

If I open the official laravel 5.6 documentation it shows up in this order:


1. Prologue
2. Getting Started
3. Architecture Concepts
4. The Basics
5. Frontend
6. Security
7. Digging Deeper
8. Database
9. Eloquent ORM
10. Testing
11. Official Packages

This order makes it super easy to get started with laravel 5.6 and understand the documentation.

If I open the laravel 5.6 devdocs documentation, it shows up in this order:


1. Architecture Concepts
2. Database
3. Digging Deeper
4. Eloquent ORM
5. Frontend
6. Getting Started
7. Official Packages
8. Prologue
9. Security
10. Testing
11. The Basics

This order makes it harder to understand and get started with laravel 5.6.

It will be great to have something that could be added in the preference section to enable/disable the default documentation order to make it easier for understanding new concepts and this would also attract more developers to devdocs.

Activity

  1. ascii-dev commented on Dec 20, 2018

    @ascii-dev

    I would be glad to take up this and work on it over the holidays. I might reach out to ask a couple of questions though @tauseefsshah. Hope that is fine by you?

  2. jmerle commented on Dec 20, 2018

    @jmerle
    Contributor

    Nice! If you need any help, feel free to have a chat with other contributors on Gitter :)

  3. ascii-dev commented on Dec 20, 2018

    @ascii-dev

    Sure I will. Thanks much @jmerle

  4. changed the title [-]New feature request: Order of the content in the documentation[/-] [+]Retain original order of the content in the documentation[/+] on Jan 29, 2020
  5. the-real-i9 commented on Nov 11, 2021

    @the-real-i9

    Wow! I was just about to suggest this feature, the guidelines directed me here. I'm thinking if there could be a separate page that arranges the links in the original order. Users could just follow from there. It's a very great user experience.

  6. added 2 commits that reference this issue on Oct 19, 2026
    7199a23
    c6f2143
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      ⌂ Proxy