Integrate the angular github wiki with the official docs

[Narretz]

The https://github.com/angular/angular.js/wiki contains quite a bit of material. Some of it can also be found in the official docs (not 1:1 though), some of it can only be found there. I think it makes sense to incorporate what's good into the official doc, and either close the wiki, or keep it focussed only on the unique info. Why?

• the info is not curated regularly or strictly. It might be outdated or incomplete
• it looks official, whereas the core team involvement is basically zero
• the wiki is obscure - there's basically no indication that it even exists (maintaining it benefits very few people)
• It's better to centralize the docs efforts in one place. For that, we should make it easier for people to contribute to the official docs

That said, I'd like to get https://github.com/angular/angular.js/wiki/Writing-AngularJS-Documentation into the official docs to make it easier for people to contribute to the angular docs. Likewise, we can see what info we can include from the https://github.com/angular/angular.js/wiki/FAQ - actually, will we have license problems with moving this?
Upcoming events and training courses are the only things that might stay there, although they are probably better organized in a mailing list etc.
We could also close the wiki for participation, freeze the current state and put a big fat disclaimer on the homepage.

[petebacondarwin]

I like this idea. I think most of the wiki was written before we started generating guide docs.
We would need to go around the site/web and look for links to these pages.

@Narretz - would you like to put together some PRs?

[cayuseDev]

Hi Narretz and petebacondarwin,

I would like to help with this 'fix'. I'm new to angularJS and somewhat new to GitHub.

I'm thinking, I can put a couple of hours a week into the effort.

Please let me know - how to get started.

[petebacondarwin]

@cayuseDev - that is great news.
First, please sign the CLA: https://github.com/angular/angular.js/blob/master/CONTRIBUTING.md#cla

Then have a read through the rest of that CONTRIBUTING document.

You will need to clone the repository and setup the environment

git clone https://github.com/angular/angular.js
yarn install

Then you can build and host the documentation via

yarn run grunt -- package webserver

Finally the place where the documentation needs to go is in the guide, or maybe misc, folders:

https://github.com/angular/angular.js/tree/master/docs/content

Let us know if you need any help.