diff --git a/README.md b/README.md index bc38a78..96c1446 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,14 @@ -# minimal-emacs.d - A Customizable Emacs Base that Provides Better Defaults and Optimized Startup +# *minimal-emacs.d* - A Customizable Emacs `init.el` and `early-init.el` that Provides Better Defaults and Faster Startup [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) -The **minimal-emacs.d** project is a lightweight, bloat-free Emacs base (`init.el` and `early-init.el`) that gives you full control over your configuration (without the complexity of, for instance, Doom Emacs or Spacemacs). It provides better defaults, an optimized startup, and a clean foundation for building your own Emacs setup. +The **minimal-emacs.d** project is a lightweight, bloat-free Emacs base (`init.el` and `early-init.el`) that **gives you full control over your configuration** (without the complexity of, for instance, Doom Emacs or Spacemacs). It provides better defaults, an optimized startup, and a clean foundation for building your own vanilla Emacs setup. -Building *minimal-emacs.d* `init.el` and `early-init.el` was the result of **extensive research and testing** to fine-tune the best parameters and optimizations for an Emacs init file. *(More information about the *minimal-emacs.d* features can be found here: [Features](#features).)* +Building the *minimal-emacs.d* `init.el` and `early-init.el` was the result of **extensive research and testing** to fine-tune the best parameters and optimizations for an Emacs configuration. *(More information about the *minimal-emacs.d* features can be found here: [Features](#features).)* -**Why minimal-emacs.d?** -- **Minimal yet powerful:** A solid starting point. +If you're looking for the ideal starter kit to customize Emacs, you've found it. The *minimal-emacs.d* project is: +- **Minimal yet effective:** A solid starting point. - **Better defaults:** Improved settings for usability, UI, garbage collection, and built-in packages. -- **No forced modes:** Unlike larger frameworks, *minimal-emacs.d* doesn't enable modes. YOU decide the global/minor modes to enable. +- **No forced modes:** Unlike other frameworks or starter kits, *minimal-emacs.d* doesn't enable modes. **YOU decide** the global/minor modes to enable. - **Customizable foundation:** Designed to be extended, not replaced. This README.md offers extensive recommendations for customizing your *minimal-emacs.d* configuration. (Reminder: [Never modify init.el and early-init.el. Modify these instead...](#customizations-never-modify-initel-and-early-initel-modify-these-instead)) The author uses *minimal-emacs.d* as his `early-init.el` and `init.el`, alongside **146 packages** ([See the packages that the author is using here](https://www.jamescherti.com/essential-emacs-packages/)). Yet, thanks to its efficient design, Emacs still **starts in just 0.22 seconds**: @@ -18,7 +18,7 @@ The author uses *minimal-emacs.d* as his `early-init.el` and `init.el`, alongsid ## Table of Contents -- [minimal-emacs.d - A Customizable Emacs Base that Provides Better Defaults and Optimized Startup](#minimal-emacsd---a-customizable-emacs-base-that-provides-better-defaults-and-optimized-startup) +- [*minimal-emacs.d* - A Customizable Emacs `init.el` and `early-init.el` that Provides Better Defaults and Faster Startup](#minimal-emacsd---a-customizable-emacs-initel-and-early-initel-that-provides-better-defaults-and-faster-startup) - [Install minimal-emacs.d](#install-minimal-emacsd) - [Install minimal-emacs.d into `~/.emacs.d`](#install-minimal-emacsd-into-emacsd) - [Alternative: Install minimal-emacs.d into `~/.minimal-emacs.d`](#alternative-install-minimal-emacsd-into-minimal-emacsd)