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.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI,NICE_REPLY_A,RCVD_IN_DNSWL_MED autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 6523 invoked from network); 15 Aug 2023 22:42:12 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 15 Aug 2023 22:42:12 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1692139332; b=NlCxvufWj0xvRrBxU+wqk/QF9W4JabZ4fqNnZx2OTgJM5Xkf5lbnTPZcCBeNL36ucrBXGHkz8A 3wEYtOZWa08XU7FG8dPlCLifsgbp0uiW7k3awSfMrh8nT74yjsnQ6ZfKqTgfa8fJunl6X/0O+e 41AOgjcUJxSLwGcSc+LiI02Tfxv7JyABxAttNAFCj2FeDji7dB3hbfqL/hfVDjN1LuaNoc6ag0 0KyZbgQrftsFF6GcdEGH73gBjTKTk7JQjS2/c4QIdHtsbIgvElJN29FCsteJpZMx5bO7F/m6c4 Zn05ELKzgS3a8O1kanmddlpITo/KCcEdIoiendY+cIlN5Q==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (tncsrv06.tnetconsulting.net) smtp.remote-ip=45.33.28.24; dkim=pass header.d=tnetconsulting.net header.s=2019 header.a=rsa-sha256; dmarc=pass header.from=tnetconsulting.net; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1692139332; bh=gdMg+DJV7OPpuZKxD8F0wUHFHodAHmmSMJ4pJrlfHlo=; 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=QO87qCHvRCGwkdQRCZoqqKHxltr7x884OxSUGkrdm0+fKT2jmQKyH8WaJsPsSjaTrBH8bjscc3 Qm9fR+G8kiqEt+3y1vQGzOzr9U7EZo/fTfyZejRdJglxpHaPOk/YsUkmnD2rppH4D876VXv1Na glEXipyMeG3ge8R+LXiRDQohOSFmCuo4kC7/+M+j1P0S1ZvZCC0G32JFWlQ9h7pDBJrugiYTP+ 0EhcKohvNEbHKPzrMgR2IaEEFMo8ygZZ4B3/SkjhX9ihligu1b6vZwrbBbhYh8yXOaqGwZTyJz C7fR1sf+r+nEQHvjo6UhPZwafSbjMmGGVSusMYXslwm8jg==; 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=ZYzv7RZivpW8HrYLtCQHpa7M4lilxFp5hunVHVDtRXs=; b=JHgvmnQXuj0OhhrpINQ4KwSQqp jrxGCplZ78DDM8iYO8UUt46PV7HSwBASRafjEbCdPYNbQ7w009vz98D6DSPGGpxufAwCj2pWyoMFq 2A2Uwr28gYjq6ZSe4pbGf9bD1aCck8efiSdueyFTYy8F0bVXjTHWzzHZFXMQBVrnATRuU/JPPL19B KPJlQJqaC5D9noT5q02+V9uCYEb6ZtFjr0bbMCyxAjepTwbWz4EoZByaAOL2wrwwt93yELT5JvCRk 9bSdDmgGg8CylfG/fJMOIC1MErk+4ByNh/L+PqVW2tLN5wS/vLYm1u0GlbwDOi3A3diUPKPOQ4AmS FURqQNlw==; Received: by zero.zsh.org with local id 1qW2jp-000IEg-Vd; Tue, 15 Aug 2023 22:42:09 +0000 Authentication-Results: zsh.org; iprev=pass (tncsrv06.tnetconsulting.net) smtp.remote-ip=45.33.28.24; dkim=pass header.d=tnetconsulting.net header.s=2019 header.a=rsa-sha256; dmarc=pass header.from=tnetconsulting.net; arc=none Received: from tncsrv06.tnetconsulting.net ([45.33.28.24]:34146) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1qW2j0-000HUx-0L; Tue, 15 Aug 2023 22:41:26 +0000 Received: from Contact-TNet-Consulting-Abuse-for-assistance by tncsrv06.tnetconsulting.net (8.15.2/8.15.2/Debian-3) with ESMTPSA id 37FMfFW6015772 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO) for ; Tue, 15 Aug 2023 17:41:15 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tnetconsulting.net; s=2019; t=1692139275; bh=ZYzv7RZivpW8HrYLtCQHpa7M4lilxFp5hunVHVDtRXs=; h=Message-ID:Date:MIME-Version:User-Agent:Subject:Content-Language: To:References:From:In-Reply-To:Content-Type: Content-Transfer-Encoding:Cc:Content-Disposition:Content-Language: Content-Transfer-Encoding:Content-Type:Date:From:In-Reply-To: Message-ID:MIME-Version:References:Reply-To:Resent-Date: Resent-From:Resent-To:Resent-Cc:Sender:Subject:To:User-Agent; b=bggbE8qBH6ztveJd0C2awXlgNDqeNz1PWeofyZfMKgErXDhVZZBc+WBt382V/mJaE 3MKmM+jiLFgFbrEWYWhb3L6ERXU66wQVvtNWu50KZNaR4j6OqgYEQDt2ywSpntqUNg bPEYj9WN4yfp2mhdPLcMj2VKFmt2RQszBr6MItkg= Message-ID: Date: Tue, 15 Aug 2023 17:41:10 -0500 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.13.0 Subject: Re: Tagged parameters Content-Language: en-US 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> From: Grant Taylor In-Reply-To: <884d3952-3994-c42a-e079-a34907545096@eastlink.ca> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Seq: 29136 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/23 1:10 PM, Ray Andrews wrote: > The problem of manuals being written by people who are already experts > is always hard to avoid. Who would you suggest write about ${TOPIC} if not someone that has already learned about ${TOPIC} and ostensibly has some level of mastery / expertise thereof? > Manuals must serve the person who is not already an expert and that's > 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 accessible by most people. Yes, there is some documentation that tends to qualify as more reference material and other documentation that qualifies as more teaching material. Traditional manual pages are often an example of the former. While Ho-To guides on The Linux Documentation Project tend to be examples of the latter. I believe there are places for both types of documentation. What's more is that neither type of documentation precludes the other from existing. I would much rather have something terse, dense, and quick from a 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 programmer and turn it into more friendly if not training friendly documentation.