From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 24236 invoked from network); 1 Sep 2022 21:54:05 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 1 Sep 2022 21:54:05 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1662069246; b=LH4Io3aRduwBBzUUbIHihd2EeIAd4S+ZwA2UzbdSrMGkqojCPt8gyD7wemDzVqBf7+dGginRbl IWms8K2BGYW+ga3Dz0wAhlod6uI6jGHSy8F3PV0/d5N1dusvsVql035tYRhiXUsDzFTzUBpwgh GEsPzdlHPklFOY16FE1tl6+gOtdrbi0cF7xbfhz7oSsww9kPnoSDQnbWVS2aadDyjLi22TboWp wESrcC+FZXSzgACVb/IwpWsKy/2VWddUKvXSirMqi/xCP1sek2smiSVDSgUe2HsCRCGjCuB24U LYUhIIiplfY7WXAil5XGWZRD/1yEUcbE+5QX+OjqAFpZJQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ed1-f52.google.com) smtp.remote-ip=209.85.208.52; dkim=pass header.d=gmail.com header.s=20210112 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1662069246; bh=W8cYaOXbse0NV8yq6fiQ9NC97EJSSuIC8vR2pScnGZk=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:Cc:To:Subject: Message-ID:Date:From:In-Reply-To:References:MIME-Version:DKIM-Signature: DKIM-Signature; b=BPDxtBCeW1dYan85fz1g2TL8mCSe6DEJ8y5SftPqlFr/aPy7lRIZzK+2i13iw03x/OIzGQbmED 4ENtLJqd03YfJCgTh8JrlIZQVvDHukK6UHZPfK+6/X2FHs3ty+4KGd/PRLyZTm7eQ5tGfNgq2H vqS03FkcxCCbdUrVIAwTI8m6xNwpbZ1VjDszM4Wt6F+qHgQxnYMdQL0X5NYiQd8LOOEwG4Yput 2ua39UgvpIY2cd+V1FU5/oE7zYMPQ2OB3VIaysUn4m8mmb7/B6iReQMmgCdYhddv2s2JTNfKXz g4lvtXRS8yGkDokQdaVj4IrQBxzzNZC1kdjcpIavIm8pBA==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Transfer-Encoding: Content-Type:Cc:To:Subject:Message-ID:Date:From:In-Reply-To:References: MIME-Version:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=HLolbe1NOkLblkIddu5VJ1/DGyE9pJTGtBQ3rdlaFpU=; b=HRrXNdVZiTtHqh5fMMbBegnwX/ Pjcr69GvzwgP2A5Chdl+mQyT6goF50md7Diu8iTYK6EAFeR4Y4uEB6ysGYj1KpdHxZMDWThQXm3WB B4m+Iai/rFwPolaN428rn5v7kuQwF3fo/E/mO2HkeLw7L6+djdnICNjox+Ys0Dk/MgbMpqiOMLKlP dL4VkFA+LHRRRVokNqbDqN/y89zd4osuwneVkqrGW5X6lqaGStodH7eKcmL2FqlP4tH9JPIgU1yzM ZSDwS3QDyP2/flb9iTart66J6qCsIrxRRPxrOwYDAJSrelRa3bsHp1XpgDs0WGqaFZaEBk227+0oX c6QuSQ0Q==; Received: from authenticated user by zero.zsh.org with local id 1oTs8S-000F9c-By; Thu, 01 Sep 2022 21:54:04 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ed1-f52.google.com) smtp.remote-ip=209.85.208.52; dkim=pass header.d=gmail.com header.s=20210112 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-ed1-f52.google.com ([209.85.208.52]:40471) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1oTs7b-000EUB-TV; Thu, 01 Sep 2022 21:53:12 +0000 Received: by mail-ed1-f52.google.com with SMTP id m1so412429edb.7 for ; Thu, 01 Sep 2022 14:53:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date; bh=HLolbe1NOkLblkIddu5VJ1/DGyE9pJTGtBQ3rdlaFpU=; b=b8LUjcSS6WuI0ARyDlQEng4DoHbfC9JAwUKmztg3sx7ObZx8XTLpWZ0eewcNvE88Br N8BhApVaQ9F7jW+7iYI/VDtAOk9y+2n51BW/jaqKmFX345rCUL7WvunmUPQ41jpdh6GB IaxfvGEZU6GifuisQeflekpzd57tiibxQ4Pt4H9rEesNrKJfMQ6buYFqevY+IMkl8DiZ Ukh925ofdMJyglkyhhYkajhCbOqFM9FxR94M8FTGuggKnMQV/7hgpHa+8g7gzUd6H5IL v0zT28+XYtliFxieJW/W3ulEdorr8IjpnSvJLxexOFoA7QtAT0GHo8GlQYy7JFbG8I3y xx0g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date; bh=HLolbe1NOkLblkIddu5VJ1/DGyE9pJTGtBQ3rdlaFpU=; b=m71Qf7wm2LQadvzJPA2woBN5gtNCtMLpbKs+/rd3rBfuZrg1YQbz1hzhpePfUqXLLB GanfSXDZOPSMoZ14bezHhEmlGCsBiSdcWwYrjHOv2PcmqDL57BWykjpknaPAYgI4hf0O nqZYtksXQMVs+4iCxwpSvLnChscj+hKRH3U5q6Idhk/zZrC3onlMBZ1R7s/MAc3IeW9O 9aDYFDKDXabHIkoYfQcb6WlXr6GJp6sUBF96jHEj7CcPOpOmteqlW8UwM2PhusFQQ71/ AENB6w7AdafHgSAaWKQ3i0/Ui6h2TWXs2Rwb/qx9JYn6D9yvtSwaERiU0NXJj/oKdQ48 OXjg== X-Gm-Message-State: ACgBeo3oMtaVx7x1ggUOxBC2YpYt33FZwljglYiVt8fJOAkRRSeOC9fv CBcA+HDJCBwTXfXv4Voa76LbEveCd57wHww45+0= X-Google-Smtp-Source: AA6agR4D19IbFMasEZt9M5PKqHl/Uu462ZoJnXpobO9/fdADZPkOgm+ifHyJ399lZURIphGv6R5HOkhsGrs6yErkYsw= X-Received: by 2002:a05:6402:1a36:b0:447:e249:5542 with SMTP id be22-20020a0564021a3600b00447e2495542mr25976783edb.280.1662069191379; Thu, 01 Sep 2022 14:53:11 -0700 (PDT) MIME-Version: 1.0 References: <0e8bc96d-17a7-4be2-afab-7a0fd827866f@www.fastmail.com> <5141de6b-dbee-4d4b-3b74-d95a671fa04e@luffy.cx> <33d0bd1a-4da7-416d-a92a-04ceb07d1107@www.fastmail.com> <1c9b6072-26e7-467e-b8cc-7d44f15eaf1b@www.fastmail.com> <9116efd4-7c88-4ea3-9601-9c522236fee7@www.fastmail.com> <20220831092831.GA992100@zira.vinc17.org> In-Reply-To: From: Felipe Contreras Date: Thu, 1 Sep 2022 16:52:58 -0500 Message-ID: Subject: Re: Most minimal configuration challenge To: Ray Andrews Cc: zsh-users@zsh.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Seq: 28022 Archived-At: X-Loop: zsh-users@zsh.org Errors-To: zsh-users-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-users-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: On Wed, Aug 31, 2022 at 9:17 AM Ray Andrews wrote: > > On 2022-08-31 02:28, Vincent Lefevre wrote: > > >> In short, =C2=ABzstyle ':foo:bar:*:baz' key v1 v2=C2=BB translates as = "When > >> library foo asks for the value of key in a situation of the form > >> bar:*:baz, tell it the answer is =C2=ABv1 v2=C2=BB". > > Perhaps there should be a zsh function that translates a zstyle line > > to plain English. :-) > > > Yup. Unfortunately we tend to think that experts are the ones who > should write > documentation, but they are unqualified. They write sentences that expla= in > what they already know back to themselves. It's like learning Coptic > from a book > written in Coptic. Only people who have just now learned something can > explain it in a way that other people who want to learn it can relate to > because > only the learner has the mind of a learner. Experts have the mind of > experts. > So the above no doubt makes perfect sense to the expert who wrote it and > already > understands it, but is useless to me. The whole world suffers from > this, but > especially the computer world. This is very true, in fact this bias has a name: "the curse of knowledge" [1], and it's something every writer should keep in mind. Unfortunately the only antidote is for zsh newcomers to become more active in the development of zsh which seems to be quite balkanized between the old guard (the actual developers of zsh), and the new kids (oh-my-zsh, Powershell 10K, etc). This bridge should be reduced. Also, the zsh site using a style of 1990 doesn't particularly help. Cheers. [1] https://en.wikipedia.org/wiki/Curse_of_knowledge --=20 Felipe Contreras