some links were missing, outdated, or without description tried to remedy that a bit, pulling some information from behind the links to the overview also small insertion for private config bisecting, some sembr lines (better reading flow in editor) and headline capitalisation improvements index.org duplicates a lot of info from the README and tends to lag behind, should consider options of merging - from what I know github could support a README.org that could also serve as index then, or vice versa linking the markdown readme in emacs
5.3 KiB
Doom Emacs Documentation
Doom is a configuration framework for GNU Emacs 26.3+ tailored for Emacs bankruptcy veterans who want less framework in their frameworks and the performance of a hand rolled config (or better). It can be a foundation for your own config or a resource for Emacs enthusiasts to learn more about our favorite OS.
Doom is an opinionated collection of reasonable (and optional) defaults with a focus on performance (both runtime and startup) and on abstraction-light, readable code design, so that there is less between you and Emacs.
The documentation is designed to be viewed within Doom Emacs. Access it by pressing
SPC h d h(orC-h d hfor non-evil users), or search it withSPC h d s(orC-h d s).
Table of Contents TOC
TODO Release Notes
Documentation
Getting Started
- Install
- Update & Rollback
- Configure
- Migrate
- Troubleshoot
Frequently Asked Questions
- General
- Configuration
- Package Management
- Defaults
- Common Issues
- Contributing
TODO Contributing
- Where to get help?
- Reporting issues
- Suggesting features, keybinds and enhancements
- Contributing code or documentation
- Other ways to support Doom Emacs
- Special thanks
Community Resources
Asking for Help
Project Roadmap
- Development roadmap - A timeline outlining what's being worked on and when it is expected to be done.
- Packages under review - A sitrep on third party plugins that we've considered, rejected, or awaiting integration into Doom.
- Upstream bugs - Tracks issues originating from plugins and external programs that Doom relies on.
Tutorials & Guides
-
Doom Emacs
-
Emacs & Emacs Lisp
- The Official Emacs manual
- A variety of Emacs resources - https://github.com/ema2159/awesome-emacs
-
Quick crash courses on Emacs Lisp's syntax for programmers:
-
Workflows for customizing Emacs and its packages (and its C/C++ modes):
-
Tools in Emacs
-
Vim & Evil
Projects that support/complement Doom
- plexus/chemacs2 - emacs profile switcher
- topgrade - system updater that includes doom
Similar Projects
- purcell/emacs.d - a wise mans long-grown emacs config
- seagle0128/.emacs.d - centaur emacs, a personal distribution
- syl20bnr/spacemacs - spacemacs, an alternative community-driven distribution