Elaborate the motivation for the "newcomers-presets" theme

This commit is contained in:
Philip Kaludercic
2026-03-27 10:29:00 +01:00
parent 9b5a9c90d2
commit 07baef0aff

View File

@@ -21,11 +21,20 @@
;;; Commentary
;; A theme that enables user options new users might be interested in.
;; The guideline to enabling a feature is "would this interest someone
;; who wouldn't even know that this option exists?". Please avoid
;; opinionated cosmetic changes, that is the job of regular/color-scheme
;; themes.
;; This theme configures user options that we can reasonably expect the
;; average, new user to want to enable, but would otherwise be unlikely
;; to discover on their own. This includes support for convenience
;; features, adjustment of default settings that are in place for
;; historical reasons, aiding discoverability (at the potential cost of
;; more visual noise) and trying and follow common conventions that
;; other editors have established over the past decades.
;; The goal is to help providing a better starting point for users who
;; would otherwise feel overwhelmed when first starting to use Emacs,
;; without having to burden existing users with invasive changes to
;; Emacs' default behavior. Options in the theme should NOT hinder
;; developing a better understanding of Emacs (e.g. enabling emulation
;; modes) or make opinionated cosmetic changes.
;;; Code: