Update core documentation

[hlissner]

Important

This is a roadmap issue and is used solely to announce and document progress (to make it easier for users to follow and maintainers to track). Please do not use it for discussion; use our discussion board instead.

The in-repo documentation is sorely out of date. This issue consolidates all open issues and pull requests for them into one. A total rewrite of our docs is in the works, which will resolve all the listed issues. Progress will be published here.

• Conflicting documentation on how to install Doom #8548
• docs(macos): add emacs-builds to getting_started.org #8527
• docs: update links in documentation and modules index #8404
• Update system paths, repository path, and NixOS package name #8341
• Add Spanish translation of README and link to it #8304
• Update emacs-plus installation instructions #8301
• docs(cli): remove references to clean #8139
• Reference ~/.config/emacs instead of ~/.emacs.d in getting_started.org #8122
• Install symbols nerdfonts during doom install #8112
• Installation guide is out of date - refers only to Emacs 27 #7686
• Installation approach different between README and getting-started.org #7631
• docs: update install instructions for macos #7570
• docs: use pacman -Syu in Arch Linux install instructions #7406
• docs: update install instructions for emacs-mac w/ homebrew #7371
• Emacs.app location incorrect for emacs-mac #7252
• docs: warn about disabling core packages #7216
• Update instructions for installing emacs through emacs-plus in M1 macs #7142
• Inconsistent first step of installation in README vs Getting Started #7135
• "Cannot find entry with ID ..." when navigating built in documentation #7056
• getting_started.org missing MSYS2 based Windows installation method #5694
• README.MD unworkable links #5663
• Document Doom runtime optimizations #4128
• Please install evil-tutor by default #3670
• [BUG] Assets links in documentation are broken #2163
• Documentation should be clarified (Customization, FAQ) #372