From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id IB6uDp6AVGGOtwAAgWs5BA (envelope-from ) for ; Wed, 29 Sep 2021 17:05:02 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1 with LMTPS id wIImCp6AVGFYawAAbx9fmQ (envelope-from ) for ; Wed, 29 Sep 2021 15:05:02 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D3E9F3509F for ; Wed, 29 Sep 2021 17:05:01 +0200 (CEST) Received: from localhost ([::1]:45696 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mVb8m-0003wQ-Ul for larch@yhetil.org; Wed, 29 Sep 2021 11:05:00 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:42102) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVb6M-0001hV-Kn for guix-devel@gnu.org; Wed, 29 Sep 2021 11:02:30 -0400 Received: from h87-96-130-155.cust.a3fiber.se ([87.96.130.155]:51626 helo=mail.yoctocell.xyz) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mVb6J-0006Kg-A5 for guix-devel@gnu.org; Wed, 29 Sep 2021 11:02:29 -0400 From: Xinglu Chen DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yoctocell.xyz; s=mail; t=1632927741; bh=vGWsXRTRdfHddg6eiUCnV2degxo4hDqdhnTjf76tV1A=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=E8/Hxff+YGyuu3iSlJgrsmib1B9L81bsxX1JVVW7Q0Wxzq9bLgBryZ4Tj8nKYEN/6 t9mduzWpHphPpps3t/FR07hNeGbX6ZDdITF7b4jEboTsubVTXKN31C2ycf1DxuQ5JL luzLo6u1VdfuB1XqTxsp8BRgSaCNQgrM6VdU7Jbo= To: Katherine Cox-Buday Subject: Re: Merging wip-guix-home to master In-Reply-To: <875yujqxhk.fsf@gmail.com> References: <87sfxvehyf.fsf@trop.in> <87sfxujdp2.fsf@yoctocell.xyz> <8735ppgg6d.fsf@trop.in> <87y27f1uh2.fsf@yoctocell.xyz> <875yujqxhk.fsf@gmail.com> Date: Wed, 29 Sep 2021 17:02:18 +0200 Message-ID: <87pmsr1l39.fsf@yoctocell.xyz> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Received-SPF: pass client-ip=87.96.130.155; envelope-from=public@yoctocell.xyz; helo=mail.yoctocell.xyz X-Spam_score_int: 14 X-Spam_score: 1.4 X-Spam_bar: + X-Spam_report: (1.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FROM_SUSPICIOUS_NTLD=0.499, PDS_OTHER_BAD_TLD=1.999, PDS_RDNS_DYNAMIC_FP=0.001, RDNS_DYNAMIC=0.982, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: guix-devel@gnu.org, Andrew Tropin Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1632927901; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=jiL8UpNeQsDyjVLbrEaMgao8eflWpbWi8nFP9ROUcmg=; b=QqS7loKCEDJOoeKy/AMuS2fAa6Nqu9iBlOQveAmnVHA50wa6p1mBo8jR+r8tg6NxcDBI0/ GDEMJhKV9nN3k01vx86MJErMnHHT1LUFmQLLHDyBYptAORflOIZdr17igvWZJdyhRw8EH1 4+PMKuHQydVbCb5jEhScxPDhvCPM/SYHsHKAqbf3IeM9/61AgjQuRi36Ag+QN3AoM1qn+t 5ZGPMAkoPiA1d5TlWJs9Gi4q4CQZ/5Tgk1kTgJ0GiP7uX54T7F23ecOPAmvR15OjTEr2Pq /tua5EviEZYSCQ8oQZcN+G4xJhGY7e8cLdwPfHANZykO6TMksEpmOpFOAusoFg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1632927901; a=rsa-sha256; cv=none; b=LLgCbY0vJ1gw8MQS5+m9NJAoxnmt+SUbM8NdPF7vQ/pp6U3mXEou6dPCYftUmKIVf6GnDc 9YHaH1bkMTNrsmGRD59G6bgwEqbeYh/uEqXGiSrDg3N3B4Q2NaOPlxDvstcqYrV7SXuNlF qlfmHOIX6BRZshYlkSq4YOgZRIDn0vAy6Zt9RsYlVi2FsVr4+y0i70xr1k0yJQyBrUrkjF FCK0OWA9zt3/+emwcZizvghVkKlDXGvF3gOAkto2tonnGrAdm8pAbty5GXHVy20XIDO2de sPWvIcIsuXr6anXhAdFimguy9YozdSY7BdPPM7NhSd+6RFLX4AGwL4otol8N3g== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=yoctocell.xyz header.s=mail header.b="E8/Hxff+"; dmarc=pass (policy=none) header.from=yoctocell.xyz; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Spam-Score: -6.10 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=yoctocell.xyz header.s=mail header.b="E8/Hxff+"; dmarc=pass (policy=none) header.from=yoctocell.xyz; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Queue-Id: D3E9F3509F X-Spam-Score: -6.10 X-Migadu-Scanner: scn1.migadu.com X-TUID: QT1tWv9fw8PP --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Wed, Sep 29 2021, Katherine Cox-Buday wrote: > Xinglu Chen writes: > >> I disagree, I think it=E2=80=99s OK for things like (guix git), which ar= e mainly >> used by developers, to not be documented in the manual. > > I strongly disagree with this. As a long-time developer, I have used > documentation both as a user and as a developer many times. > > Documentation is for everyone. I said =E2=80=9Cto not be documented in the manual=E2=80=9D (the majority o= f (guix =E2=80=A6) modules aren=E2=80=99t documented in the manual); that doesn=E2=80=99t mean= that there aren=E2=80=99t any docstrings. The manual says that all top-level procedur= es should have docstrings (see =E2=80=9C16.5.4 Formatting Code=E2=80=9D) We require all top-level procedures to carry a docstring. This requirement can be relaxed for simple private procedures in the =E2=80=98= (guix build ...)=E2=80=99 name space, though. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJJBAEBCAAzFiEEAVhh4yyK5+SEykIzrPUJmaL7XHkFAmFUf/oVHHB1YmxpY0B5 b2N0b2NlbGwueHl6AAoJEKz1CZmi+1x5tOIQAKha4J2amQepw/+uOT20ng8z46CD 83k0lBHPJYPJ2LUsY4NoSx4MkcmJJOe1DxBIvb5krtP/lp/q2qsg9wxg0v/b2IJT u2GajPSkGIEVh/iHnMVDdqrWi0O8kojFaUPRuVqgoE8i5YHHQ8A1kuFQCzJwdpfh 4bBgL+AMyraMHFQ28MNPMU58++Sd7gsTmhcB2ZobWMHRr4TZQvmTVTgrYdgiZJ2a RJwtBVupWiKjb0/xrVqwrVF6Xp69jQsGE8MIA8qYm/5PVlODPJn8zZLHsHfJiwDD kEICwtNgiexfSEskiqMJa3sku13I1WGplTJ6MLFMIj7IjXxAxuPMgVHXsD6CkgkN 3e1RMXgY4bwb+E94Qfv2NL4xIrPECJsnrKODNc1q1eIyNQaMegbXn6mqBBsipjzx 4teJebPYWfYUF/amWcNYcNapqQtkPFpBjazEDAV6nI5GYJpHAqGa9q7IEaC5CIk4 QcOY1CCkRT0Y1IVyz9GaalukJXX4u8Or6RBlRBuk3DUk/jcE+XsckA+THhoiJfLT ocJ0MBeffy60CIyKM1owAgjUi+BgU6k1QFeNd1vkhPj0sfte7Oo3MGMzLywr8Ro1 l1YVaR2FlFSdDSTR4TjQC+PRHwWPOC6Ulz82LnWVD/+eAwVVGPhX3gdUBlutNzjs oKGDlD6OdG2gL8d/ =E3jf -----END PGP SIGNATURE----- --=-=-=--