Move wiki documents under @docs/` and update them

[shu-mutou]

Reasons

1. Due to instruction by k8s org, only maintainer can edit wiki pages since this year.
2. Therefore, contributor can not propose documentation updates by PR.
3. Wiki contents are out of dates. Partially fairly.
4. Before release 2.0.0, we need to update docs.

TODOs

• for 2.0.0 or later
  • Reorganize docs/, create indexes and blank pages. Reorganize docs/ #4009
  • Fill blank pages with new descriptions or add new pages if needed. (divided work)
• for 1.10.1 or before
  After migration to docs/, revert wiki for <=1.10.1.
  • Revert wiki revision to 1.10.1 (to the end of last year). (maintainer only)
  • Add notice for <=1.10.1 on wiki pages. (maintainer only)
  • Add link to docs/ for >=2.0.0" on wiki pages. (maintainer only)
  • Let's consider migration of docs for <=1.10.1 later.
    Old documents are all removed.

[shu-mutou]

Please raise your hand to the part that you can help and submit PR.
Wiki pages to be migrated and assignee (needed merging #4009):

• Common
  • FAQ @floreks Update documentation #4793
  • Roadmap Continue operation on wiki
  • Dashboard arguments @shu-mutou Migrate docs for dashboard arguments #4164
• User Guide
  • Installation @shu-mutou Migrate documentation for installation #4220
  • Certificate management @shu-mutou Migrate documentation for installation #4220
  • Accessing Dashboard @shu-mutou Migrate docs for Accessing Dashboard #4224
    • 1.7.X and above @shu-mutou Migrate docs for Accessing Dashboard #4224
    • 1.6.X and below @shu-mutou Migrate docs for Accessing Dashboard #4224
  • Access control @shu-mutou Migrate docs for Access control #4249
    • Creating sample user @shu-mutou Migrate docs for Access control #4249
  • Integrations @floreks Update documentation #4793
  • Labels @shu-mutou Migrate docs for Labels #4062
• Development Guide
  • Getting started @shu-mutou Updte parts of docs for developer guide #4012
  • Release procedures @shu-mutou Migrate docs for release procedures #4169
  • Dependency management @maciaszczykm Migrate some of the docs #4052
  • Architecture @maciaszczykm Migrate some of the docs #4052
  • Code conventions @shu-mutou Updte parts of docs for developer guide #4012
  • Text conventions @shu-mutou Updte parts of docs for developer guide #4012
  • Internationalization @shu-mutou Updte parts of docs for developer guide #4012
• Plugin Guide @ajatprabha Add docs for plugin development #4276

[maciaszczykm]

Once the docs are moved we should also update docs button on About page in the app.

Done in #4052.

[maciaszczykm]

We should close the Wikis once this will be done.

[maciaszczykm]

Arch image should be updated to replace Heapster.

[maciaszczykm]

Please also add #3504 (comment) info to the docs. Can be placed in FAQ or some dev doc.

Notice that YAML location changed and add also URL to enter the app.

[maciaszczykm]

@jeefy Would be nice if you would describe dev process with the metrics. Some manual, tips etc.

[maciaszczykm]

export GO111MODULE=on should be part of the docs too.

[jeefy]

/assign

[shu-mutou]

export GO111MODULE=on should be part of the docs too.

it would be done in #4169.

[shu-mutou]

export GO111MODULE=on should be part of the docs too.

Done in #4169

[shu-mutou]

@maciaszczykm @jeefy I'm unlikely to be able to update FAQ, Roadmap and Integrations well. Could you guys update them?

[maciaszczykm]

For FAQ, it's worth to mention that kubectl -n kubernetes-dashboard port-forward svc/dashboard-metrics-scraper 8000:8000 allows to test metrics locally.

[shu-mutou]

For FAQ, it's worth to describe increasing kernel setting fs.inotify.max_user_watches on host when developer faces Error: ENOSPC: System limit for number of file watchers reached, watch in npm start.

To increase the parameter, run echo fs.inotify.max_user_watches=582222 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p.

[nathansmyth]

These updates are creating broken links support sites, including the issues in this project.

Is there a way to redirect from the wiki to the new address?

For example, going to https://github.com/kubernetes/dashboard/wiki/Creating-sample-user now redirects to the wiki home page. And from what I'm reading in this issue, soon all documentation links will do the same.

Here are two examples of where this issue is occuring:
Azure/aks-engine#805
#2787

[maciaszczykm]

Also #4121 should be covered by this issue.

[shu-mutou]

Wiki contents that should be migrated to /docs have fully migrated.