Skip to content

Organize long docs into shorter parts for users with different needs #48466

@jurikonradi

Description

@jurikonradi

Describe the problem that you experienced

Hi, I'm new to Angular and often need to read the documentation. For the second time I have experienced this problem: you explain something that require me a hour or two to read and (partially) understand, and then you say something "but for big real-world applications, forget what you just have read, and read this instead (another hour to spend)".

In particular this apply to 1) routing 2) forms.

Probably 95% of Angular users are working on large applications, so Lazy-Loading should be explained first. I think it will save a lot of time if in the beginning of routing docs, you said something like "if you building small app, than read this, if you building big app - go to lazy loading docs".
Same apply to forms - everybody probably uses form control, why you teaching template forms first? Divide this docs at the beginning.

I hope my proposal will help people dig into Angular.
Thank you, Juri.

Metadata

Metadata

Assignees

No one assigned

    Labels

    P3An issue that is relevant to core functions, but does not impede progress. Important, but not urgentarea: docsRelated to the documentation

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions