Documentation from the perspective of newcomers

[piomar123]

Hi, when reading the docs I have a feeling of being overwhelmed. Even though I've been using Bootstrap 4 some time ago, I wanted to refresh my knowledge and see what's different in version 5.
Could you rethink the documentation from a perspective of someone who heard about Bootstrap and wanted to use it in their project, and has basic knowledge of HTML and JS?

Let's take a look at the Introduction section:

What the user is introduced with, is a basic HTML structure for Bootstrap to work, which is good, but then, it's not really clear what to read next to actually get something nice created. There is a big Next steps section, but:

• "Read a bit more about some important global environment settings that Bootstrap utilizes" - this link leads to the section half a page below which is not really necessary, it just makes the navigation more complex
• "Read about what’s included in Bootstrap in our contents section" - this one sends to contents section which suggests that we might need more files to download to start working
• "Need a little more power?" - no, I just want to start hacking with Bootstrap first, to check if this is even for me

To be honest, the natural "Next step" should be just reading the page to the end first. I.e. why is this section in the middle of the page - it should be at the end.

Then, the user looks at the navigation sections and sees "Customize" above "Layout"

This strongly implies that to use Bootstrap, we might need to modify the sources.

I would suggest to move "Layout" section above "Customize", make it more clear to read about the Grid and layout in Bootstrap. Maybe even create one more page under Introduction that describes them in a concise way. Take the w3schools tutorial as an example - it feels more beginner friendly but is not an official documentation and might contain errors and now follow the latest changes.

Hope this makes some sense. Let me know what you think (maybe I'm just a noob).