New docs is hard to read and understand about v6-docs HOT 3 CLOSED

I'm speaking about some logical changes. But anyway, I understand your point and I will take all of them, one by one, to try to improve documentation.

Yup, incremental changes will be easier for everyone including me. It's hard for me to take such a huge feedback and take any action with it.

Also, one more thing which might be clear from our communication. AdonisJS documentation is a reference guide and does not aim to serve as a tutorial.

What is a reference guide (as per our understanding)?

A reference guide is something you can reference as you try to build something with AdonisJS. You use it to get technical knowledge about a particular topic.

• Reference guides are not sequential in navigation.
• They do not teach how to build something end to end.

We need a tutorial and that will be its own thing.

from v6-docs.

Sorry, I did not read the full message since it appears expecting us to change almost the entire documentation without first trying to understand our intent behind writing it.

I suggest pick one topic at a time and discuss if that needs improvement. For practical reasons, I do not see myself changing the entire documentation upside down

from v6-docs.

Sorry, I did not read the full message since it appears expecting us to change almost the entire documentation without first trying to understand our intent behind writing it.

I suggest pick one topic at a time and discuss if that needs improvement. For practical reasons, I do not see myself changing the entire documentation upside down

Hello,

I do not want to change the entire documentation. Actual content is great!

I'm speaking about some logical changes. But anyway, I understand your point and I will take all of them, one by one, to try to improve documentation.

from v6-docs.