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=-4.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,NICE_REPLY_A,RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 23443 invoked from network); 17 Aug 2023 23:41:44 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 17 Aug 2023 23:41:44 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1692315704; b=OGuWh3Fe5JsSyVVVprfrk6jOY7G60MqLhu0+A7CB3VZrd6u9u4hHuwxQXug0v/Grxt2jtSUEFs +KJQhDahdCw8KIcCLfXfqKovDTS2YP9NoYfNyn07QxAAGjzqO7ZmZyYjzvy482YkoJvyGecHx8 uD33VLk2q41AwYiJZcbfz83QSA+cRndZMo6n5WMy5E3Z/kZRUqEtyjC20f9rNxtvqewqq6fngi G8PTMRGDBF3MullYLuGBb++CG8sCQ4v7LWv/vhjWCAReZkHsPKIYHKWABMDhsCmsxglnow0but NbEz83z4P3I+D5iBn3nMQ1ZQJKZMxHEvPliCEevP0cdcHg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (iris.zentaur.org) smtp.remote-ip=198.58.127.206; dkim=pass header.d=zentaur.org header.s=dkim20200120 header.a=rsa-sha256; dmarc=pass header.from=zentaur.org; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1692315704; bh=nTXgAuj6Lhs5n67BhLuJ7j+0KFO+mr5/qZjBkcbYh4c=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Transfer-Encoding:Content-Type:In-Reply-To:From: References:To:Subject:MIME-Version:Date:Message-ID:DKIM-Signature: DKIM-Signature; b=GpHY1QtcyxIHmEUZGUMR6wrEBxIcqORzjXO1KezCUMcnkxW8iqvR05mSv3w4Ot+sWvE/IZLuZD OKvJOXMMMjjXpjHPcEhWVYdC/b8+LqlgnQ8Y3ZTT69zyQyX+h6g7U8t71rEbxjA5+uko74+dYt kAWffowCjNfe2PKIeyKaIyNrF6yus09Hxu5unhJl0b3UWhfsL2r73Jiptj/sMKl6BohYjiB/M4 FV2yIy4RFa/OmPbnCM1PYO3bp6VQ81aatidaFqQFfxR7ZURsGgj9ogsftH9nMukx3HgEXPtdUl JE4zhoedsTJvWzAoOo1B380tHWKwKEZlmHR6NRPF6hrOUA==; 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:In-Reply-To:From:References:To:Subject:MIME-Version:Date: Message-ID:Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From :Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=nTXgAuj6Lhs5n67BhLuJ7j+0KFO+mr5/qZjBkcbYh4c=; b=l52q/+pU5EMJHmuzwXkbBlAok7 VTrOP7635r1b9AhcC1bmZtGm7vtGq0ycL5IpWssgOFCU37nA0uTFNv98Ilwq3IwBf54gg1pAlNxL7 iGx7FW80wYXze8Md+SADG13BXvbhGsS+Ra1yzpWTp/72h+DtMp25jDZbVr1YFfIyrStGDUkg70lud gkESuQg8YX4fsng+UVZdqRYNPaO68W6YAoJmyuw3YRMMmYvxaR4mQZROIIMtPYo8xl3bAs57njQUC eHQIgA23R2seO+w+B6kTN8Pv8v+wWxqVAXhbJeW6f1GYhut2zrm+tYIag8ekLiErBEEqwe3Oydshd T9V/btBQ==; Received: by zero.zsh.org with local id 1qWmcZ-000Hov-NN; Thu, 17 Aug 2023 23:41:43 +0000 Authentication-Results: zsh.org; iprev=pass (iris.zentaur.org) smtp.remote-ip=198.58.127.206; dkim=pass header.d=zentaur.org header.s=dkim20200120 header.a=rsa-sha256; dmarc=pass header.from=zentaur.org; arc=none Received: from iris.zentaur.org ([198.58.127.206]:47726) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1qWmbw-000H7m-AE; Thu, 17 Aug 2023 23:41:06 +0000 Received: from iris.zentaur.org (localhost [127.0.0.1]) by iris.zentaur.org (Postfix) with ESMTP id 4RRhMz20vtz3wZp for ; Thu, 17 Aug 2023 23:41:03 +0000 (UTC) Authentication-Results: iris.zentaur.org (amavisd-new); dkim=pass (2048-bit key) reason="pass (just generated, assumed good)" header.d=zentaur.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=zentaur.org; h= content-transfer-encoding:content-type:content-type:in-reply-to :from:from:content-language:references:to:subject:subject :user-agent:mime-version:date:date:message-id; s=dkim20200120; t=1692315662; x=1692319263; bh=nTXgAuj6Lhs5n67BhLuJ7j+0KFO+mr5/ qZjBkcbYh4c=; b=lPPc58HJE67TCVmIIcVjL3uVoSI5/040iH6FOZY22hGFqNfj U4DCc4WSdh6HawB568U8+BHakp2gxtF7rDLLhbqo0JMXEzKgpzOgLeGggnYeDjZl TJLTolky5DuvOvptnppynBg2pSqFMkz+JzX7LorgtruBdGtAoDG358SRWziScdVS P+KIiPEo4YtkjyXwXI3qPFABWj9iOv0l3lAsRkj/hdZuxb4jdgy+Ud6M1jndLGiQ Gtc/xAE4dTdsdIt2wFIXPYlIAE5h5KQya6M3Js2X9kBtahjFKhp8+owgGeRGdxwi JRLvz8yrK+OYMQrg7rGNaZ69ASC0upJaO/Cheg== X-Virus-Scanned: amavisd-new at iris.zentaur.org Received: from iris.zentaur.org ([127.0.0.1]) by iris.zentaur.org (iris.zentaur.org [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id 5CPHz4gbCEQ3 for ; Thu, 17 Aug 2023 23:41:02 +0000 (UTC) Received: from [IPV6:::1] (unknown [IPv6:2605:a601:a55a:2600::1d4f]) by iris.zentaur.org (Postfix) with ESMTPSA id 4RRhMy5DDjz3wZj for ; Thu, 17 Aug 2023 23:41:02 +0000 (UTC) Message-ID: Date: Thu, 17 Aug 2023 18:41:02 -0500 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.14.0 Subject: Re: Tagged parameters To: zsh-users@zsh.org References: <2084623922.2320579.1692088070247@mail.virginmedia.com> <1239829800.2332805.1692110389939@mail.virginmedia.com> <52628f85-e41c-06de-a4a4-8d54148dfbf7@eastlink.ca> <884d3952-3994-c42a-e079-a34907545096@eastlink.ca> Content-Language: en-US From: Clinton Bunch In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed X-Antivirus: Avast (VPS 230817-6, 8/17/2023), Outbound message X-Antivirus-Status: Clean Content-Transfer-Encoding: quoted-printable X-Seq: 29161 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 8/15/2023 17:41, Grant Taylor wrote: > On 8/15/23 1:10=E2=80=AFPM, Ray Andrews wrote: >> The problem of manuals being written by people who are already=20 >> experts is always hard to avoid. > > Who would you suggest write about ${TOPIC} if not someone that has=20 > already learned about ${TOPIC} and ostensibly has some level of=20 > mastery / expertise thereof? > >> Manuals must serve the person who is not already an expert and that's=20 >> difficult because the minds are different. > > I don't agree. > > Documentation, of any sort, is better than no documentation. > > N.B. I don't consider source code to be documentation that is=20 > accessible by most people. > > Yes, there is some documentation that tends to qualify as more=20 > reference material and other documentation that qualifies as more=20 > teaching material.=C2=A0 Traditional manual pages are often an example = of=20 > the former. While Ho-To guides on The Linux Documentation Project tend=20 > to be examples of the latter. > > I believe there are places for both types of documentation. What's=20 > more is that neither type of documentation precludes the other from=20 > existing. > > I would much rather have something terse, dense, and quick from a=20 > programmer that doesn't have time to word smith than not have even that= . > > Others who don't feel comfortable can take the snippet from the=20 > programmer and turn it into more friendly if not training friendly=20 > documentation. > I always thought that was what technical writers were for. Of course, we could always hand it to ChatGPT to write the Zsh manual :)