Tracking issue for moving to rustc-guide

[mark-i-m]

The rustc guide has made a lot of progress and has almost reached parity with the READMEs. Indeed, there is a lot of content that is only in the guide!

This is a tracking issue for completely getting rid of the READMEs, which are hard to find and often not coordinated with each other, and moving towards the guide.

• Finish moving all READMEs to the guide. These are the ones that are left (I think):
  • EDIT: to reduce redundancy: https://github.com/rust-lang-nursery/rustc-guide/issues/
• Remove old READMEs that are not waiting for a system to be deleted:
  • Dependency tracking/Incr. Compl.: https://github.com/rust-lang/rust/blob/master/src/librustc/dep_graph/README.md (Replace many of the last references to readmes #49092)
  • ./src/librustc/infer/higher_ranked/README.md (Update/remove some old readmes #57652)
  • ./src/librustc_data_structures/obligation_forest/README.md (Update/remove some old readmes #57652)
    • Put this info into the rustdocs
• In Update/remove some old readmes #57652 (comment), it was decided that these READMEs are still accurate and are waiting for their corresponding systems to be removed...
  • ./src/librustc_borrowck/borrowck/README.md (Remove the last remaining READMEs #65772)
  • ./src/librustc/infer/region_constraints/README.md
  • ./src/librustc/infer/lexical_region_resolve/README.md (Remove the last remaining READMEs #65772)
• Decide where we want the rustc guide to live (in this repo or not?), then move it there.
  • It is a submodule to this repo, with the main rusct-guide repo living in rust-lang/rustc-guide

cc @nikomatsakis

[nikomatsakis]

Nice!

[mark-i-m]

Found a few more READMEs to migrate...

[mark-i-m]

Updated with next steps...