Skip to content
This repository was archived by the owner on Dec 4, 2017. It is now read-only.

First Draft of JavaScript tutorial - Part 1#1193

Closed
danielzen wants to merge 2 commits intoangular:masterfrom
danielzen:master
Closed

First Draft of JavaScript tutorial - Part 1#1193
danielzen wants to merge 2 commits intoangular:masterfrom
danielzen:master

Conversation

@danielzen
Copy link
Copy Markdown

This is my first pull request. Please let me know if I need to create a new branch, and I will.

I have been waiting for the JavaScript Tutorial, and decided to start writing it myself. I have take care so that all the snippets & the plunker for toh-1 are working well, and all references to TypeScript have been purged from this version. Note that I have elected to use Template Literals which are now available in all the major browsers. I could refactor away from them if necessary.

I have not yet created the completed toh app in JS which will be referenced in the Introduction, but I say that it is coming soon, since I will create it as I will continue to work on the JS tutorials if this first part is accepted. Thanks!

@googlebot
Copy link
Copy Markdown

We found a Contributor License Agreement for you (the sender of this pull request) and all commit authors, but as best as we can tell these commits were authored by someone else. If that's the case, please add them to this pull request and have them confirm that they're okay with these commits being contributed to Google. If we're mistaken and you did author these commits, just reply here to confirm.

@googlebot
Copy link
Copy Markdown

We found a Contributor License Agreement for you (the sender of this pull request) and all commit authors, but as best as we can tell these commits were authored by someone else. If that's the case, please add them to this pull request and have them confirm that they're okay with these commits being contributed to Google. If we're mistaken and you did author these commits, just reply here to confirm.

@googlebot
Copy link
Copy Markdown

CLAs look good, thanks!

1 similar comment
@googlebot
Copy link
Copy Markdown

CLAs look good, thanks!

@wardbell
Copy link
Copy Markdown
Contributor

The branch doesn't bother me (although I'd have created a branch for myself). We can work around it.

It is so generous of you to work on this contribution. Unfortunately, I fear that you'll have to rework it entirely as we are about to refresh the entire ToH series to align with the CLI and I'm afraid of what that will do to your flow.

The CLI is typescript only. In a sense, that leaves the JS version free to remain as is. But I'm not sure that is a good idea and it will complicate our end-to-end testing.

No matter what, you will want to update for RC1 as well.

Because there is so much that you'd have to redo ... I'm going to close this. We can revisit when things settle down.

Please don't take that as an adverse judgment. We're just not in a good position to correct and absorb this right now.

Please hang on to your thoughts and revisit in a few weeks. All the best, Ward

@wardbell wardbell closed this May 10, 2016
@danielzen
Copy link
Copy Markdown
Author

Thanks for getting back to me. Now that a few weeks have passed, I'm curious to follow-up.

I have no problem reworking all of this. I have been working on a course that is now Angular 2 for ES6 (formerly ES5y). The real question: Should the JS version of the documentation on the Angular.io site be about ES6 or ES2015?

Most of what I have been doing has been as an exercise for me, but I would love for it to help others. And, I figure expanding the JS documentation would be best.

Finally, is the thought that there should be no official JavaScript documentation until ng2 launches so that the direction will be clear by then?

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants