From 07baef0afffe1a163e0e07dcccd7e814c8b0b4a0 Mon Sep 17 00:00:00 2001 From: Philip Kaludercic Date: Fri, 27 Mar 2026 10:29:00 +0100 Subject: [PATCH] Elaborate the motivation for the "newcomers-presets" theme --- etc/themes/newcomers-presets-theme.el | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/etc/themes/newcomers-presets-theme.el b/etc/themes/newcomers-presets-theme.el index b14465d8e3f..9012d859943 100644 --- a/etc/themes/newcomers-presets-theme.el +++ b/etc/themes/newcomers-presets-theme.el @@ -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: