Skip to content
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

Explain better what Angular is #1139

Open
NothingEverHappens opened this issue Oct 8, 2019 · 6 comments
Open

Explain better what Angular is #1139

NothingEverHappens opened this issue Oct 8, 2019 · 6 comments

Comments

@NothingEverHappens
Copy link
Collaborator

What the issue is about

This is the first slide of the Angular milestone.
image

  1. It's a wall of text
  2. It doesn't really explain much

Where to start

Think about what would be the best way to explain what angular is, and what would be the best way to explain what it is in 1-3 slides

Write it here first, test it on real people, this is the first thing that people, it has to be concise, and very clear

@mai-am
Copy link

mai-am commented Oct 15, 2019

I have worked on a text that I have shown to a couple of people with positive feedback. It's hard to know how much detail to go into. I've mentioned the advantage of unit testing and dependency injection but otherwise not explained things like two way data binding and MVC architecture. Is there a specific file you want the suggestions pasted into?

@NothingEverHappens
Copy link
Collaborator Author

NothingEverHappens commented Oct 15, 2019

Hey @mai-am I'd start by posting it here?
This is also something we can test with (more) users to see what the feedback would be

@mai-am
Copy link

mai-am commented Oct 16, 2019

Great. Well here it is @NothingEverHappens . It's a bit long now, but always easier to cut down on text depending on how much detail you want:

Angular is an open-source framework used to build mobile and desktop applications.
Angular is a component based framework. Using Angular, each element you see on a website is an individual component. The components exist in a hierarchy.

On top you find a root component. Within this you can place several child components. Components are for example a menu bar, items in the menu bar, a text box and so forth. The components are reusable across the application.

Angular applications are built using TypeScript. Every component has a TypeScript file containing the logic and HTML pertaining to that specific component. TypeScript complies to Javascript which is then rendered in the application.

One of the benefits of Angular is that it allows you to easily unit test individual components. If components are dependent on each other or on other data the unit test can mock that dependency so the individual component can still be tested. This feature is called dependency injection and has made components easier to manage, test and reuse.

Angular is supported by Google. You might have heard of AngularJS. Keep in mind that Angular and AngularJS are different things. AngularJS was an early version of Angular that didn't support mobile.

@NothingEverHappens
Copy link
Collaborator Author

This looks like an awesome start, this seems like this can be broken down into multiple slides (5)?
It would be awesome to think through their structure and how not to overload the reader with just lots of text.

(I've had a brainblock on this issue, and couldn't figure out what to respond, sorry for the delay)

@mai-am
Copy link

mai-am commented Nov 25, 2019

@NothingEverHappens Thanks for the reply. :) I won't be able to follow up this issue for some time due to other commitments, so if someone else can take it from here that would be great.

@mai-am mai-am removed their assignment Nov 25, 2019
@NothingEverHappens
Copy link
Collaborator Author

Thanks @mai-am

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants