X Tutup
The Wayback Machine - https://web.archive.org/web/20200628004539/https://github.com/angular/angular/issues/34428
Skip to content

/ angular

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Get Started user flow enhancements #34428

Open
SujitSingh opened this issue Dec 16, 2019 · 3 comments
Open

Get Started user flow enhancements #34428

SujitSingh opened this issue Dec 16, 2019 · 3 comments
Labels
comp: docs freq2: medium severity1: confusing type: feature
Projects
docs
Milestone
Backlog

Comments

@SujitSingh
Copy link

@SujitSingh SujitSingh commented Dec 16, 2019

Suggestion to improve the Get Started user flow -

  1. "Get Started" links should point the user to a page with information regarding the creation of a new project, such as the Setup page.
  2. After that, we should provide Angular's architecture overview, something like Architecture Overview in simple terms.
  3. Then, introduce the user to Your First App as it is. Later ask the user to continue with the Tour of Heroes App tutorial to give them a real taste of developing an Angular app.

Why these suggestions?

  • There is front-end framework war out in the world and every non-Angular developers say that documentations are hard to understand. This gives them one extra reason to move away from Angular.
  • Few Front-end devs in my team informed me that they couldn't clearly get things which are required to start with Angular. They mentioned that they had to navigate a few pages to get started. When I tried a fresh start by myself, I too couldn't find things clearly, even though I have been visiting Angular.io since 2017.

Above suggestions are from a few devs from my team(freshers and experienced). We will be more than happy to get further suggestions in order to improve the above starter flow even better.
@kara kara added the comp: docs label Dec 16, 2019
@ngbot ngbot bot added this to the needsTriage milestone Dec 16, 2019
@ajitsinghkaler
Copy link
Contributor

@ajitsinghkaler ajitsinghkaler commented Dec 16, 2019 •
edited

@kapunahelewong do you think we should implement these changes. Seems like some nice suggestions
@kapunahelewong
Copy link
Contributor

@kapunahelewong kapunahelewong commented Dec 17, 2019

Thank you for taking the time to share your thoughts here, @SujitSingh. I will share this with the Docs Team as we are continually working with these same kinds of thoughts in mind.

@ajitsinghkaler, these are indeed some nice suggestions, but as it encompasses some significant changes, I'd like to make sure @aikidave and @jbogarthyde are in on the conversation.
@ngbot ngbot bot modified the milestones: needsTriage, Backlog Dec 17, 2019
@kapunahelewong kapunahelewong added this to Pending - Top of backlog in docs Dec 17, 2019
@aikidave
Copy link
Contributor

@aikidave aikidave commented Dec 17, 2019

This is great feedback. Thanks! We (the docs folks) are currently looking into how to make it easier to understand and adopt Angular--your insights are really helpful!
@jbogarthyde jbogarthyde mentioned this issue Feb 18, 2020
Closed
4 of 14 tasks complete
@jbogarthyde jbogarthyde linked a pull request that will close this issue Feb 20, 2020
Rework nav to improve startup experience #35533
Closed
4 of 14 tasks complete
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
comp: docs freq2: medium severity1: confusing type: feature
Projects
docs
Pending - Top of backlog
Milestone
  Backlog
Linked pull requests

Successfully merging a pull request may close this issue.

Rework nav to improve startup experience
5 participants
@kara @kapunahelewong @SujitSingh @aikidave @ajitsinghkaler
You can’t perform that action at this time.
X Tutup