From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Catonano Newsgroups: gmane.lisp.guile.user Subject: Re: [ANN] Guile Hall 0.3.0 released Date: Mon, 25 May 2020 08:31:18 +0200 Message-ID: References: <87k11bdh0k.fsf@gmail.com> <874ksfd2d0.fsf@gmail.com> <877dxaefr8.fsf@gmail.com> <87y2pqcmox.fsf@gmail.com> <79722626938f0660f261154a697ccd16198744e3.camel@gmail.com> <87pnatc9jo.fsf@gmail.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="00000000000016faba05a67321bc" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="102908"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Guile User , =?UTF-8?Q?Ludovic_Court=C3=A8s?= To: Alex Sassmannshausen Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Mon May 25 08:32:24 2020 Return-path: Envelope-to: guile-user@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jd6et-000Qik-4v for guile-user@m.gmane-mx.org; Mon, 25 May 2020 08:32:23 +0200 Original-Received: from localhost ([::1]:48334 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jd6es-0007kj-1F for guile-user@m.gmane-mx.org; Mon, 25 May 2020 02:32:22 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58812) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jd6e6-0007jF-Ut for guile-user@gnu.org; Mon, 25 May 2020 02:31:34 -0400 Original-Received: from mail-yb1-xb35.google.com ([2607:f8b0:4864:20::b35]:35331) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jd6e5-0000bg-8v; Mon, 25 May 2020 02:31:34 -0400 Original-Received: by mail-yb1-xb35.google.com with SMTP id u73so5445181ybi.2; Sun, 24 May 2020 23:31:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=SJIqEjnekwkXvKp5iIFTA5FgV+rdnH6G7diSp4YPYeM=; b=YPPl3wxMNvHgD7UOof2eB0jubafzPoDlhVQpsgcQe93soRxuIylf964J9OimvlKOfc w96hnOGglNu6AtS/SBhB2IUCuFXfDKiTiubVRboI0ELWxNP2KuQN/cGNNAcZvNH9Ar6x F9oGZBmezu06Zofgx3ZphNFiWuplEBmXMKhPK5MJJkTWVbNI+5GSBaJEOEWfwBOrEux2 Oh1/L7AhEj59fZ/XdjlYjxTB+Tnd5IrAy5E+1WzvEHRAcmqImbI0jSRem18rGCcouWhe yBKrWwSmDn9BxLjU9kXZv01unKam9IFWfGTqgX3N9+opOSQZRERiulEK3yFcDGpJJL9V vDyg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=SJIqEjnekwkXvKp5iIFTA5FgV+rdnH6G7diSp4YPYeM=; b=GqiL5D45wo8xmd+7++n9hTEpHhKtAdgCg4xaCIkuFoG4gKUU211LQ6oiE1y/bczYI7 XOMn9R2sg5b9275/C5kulPYcSVAuguYu3Fz/84qdDpEvZT5ILcccWEMRCW3161uDFxEn nuaao9db0kHryedE5mfbwrfXa2AQZFrUnsFdatW73LA7Ke/HXilBsd1Ejwjv6g8vkiny DRd1+3QiCBnzzqjauYKqh7p7VVHq+C2ylt5gL2ly+vpxwGVcGxNJ8A9u/J58R9MIepfE GOoZwVirfjt2zxQfY61A7/8vYfCicwHtQ38wYIACgJLnW3HhX04w54Xtj4OOOPubdCzC zmsQ== X-Gm-Message-State: AOAM531pn95c3TSrLsa5+/4kqbsW6dE14AR/j8llm8Sw83l0XbB11HLp UXXTKUchV7ChDvd01DU7eYDoYDhEcPwMgzXO7g== X-Google-Smtp-Source: ABdhPJwGCgTnDDcW1vPz+r/LuxlFOvxlYbd4s0Omh/NKCIGdNem5bv5AqInBsd/b+axgaFxwUgPnp0lDZhK857uGV1E= X-Received: by 2002:a25:bbd2:: with SMTP id c18mr20997799ybk.46.1590388290145; Sun, 24 May 2020 23:31:30 -0700 (PDT) In-Reply-To: <87pnatc9jo.fsf@gmail.com> Received-SPF: pass client-ip=2607:f8b0:4864:20::b35; envelope-from=catonano@gmail.com; helo=mail-yb1-xb35.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-Content-Filtered-By: Mailman/MimeDel 2.1.23 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.io gmane.lisp.guile.user:16507 Archived-At: --00000000000016faba05a67321bc Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Il giorno dom 24 mag 2020 alle ore 23:22 Alex Sassmannshausen < alex.sassmannshausen@gmail.com> ha scritto: > Hey Catonano, > Hi Alex ! Thank you for your review =E2=98=BA I liked the style of your text. I've taken the liberty to expand on it > some more =E2=80=94 but I'm happy to go with your version if you / the > maintainers prefer. > I'd go with my version, if you don't mind > > Also, I changed references from guile-hall to Hall. Whilst the name of > the folder etc is guile-hall, the project itself is called Hall, or > Guile Hall to make it part of the Guile family :-) > Well, yes, I welcome this suggestion of yours ! The project name is "Hall", not "guile-hall" Just a few words on why I'd prefer my version There are 2 sentences in your version that i find debatable The first one is: "Hall helps you create, manage and package your Guile projects through a simple commandline interface" because there is nothing in Guile that is not meant for usage at the command line, unfortunately Also, the Autotools documentation suffers from the same problem of almost ALL the GNU documentation: it's focused on properties and features and completely (?) disregards user stories Because of this reason, if I was a neecomer reading the Guile manual, I wouldn't be able to associate the "create, manage and package your Guile project" to the API offered by the Autotools machinery Such association is not stated anywhere, as far as I can tell So I'd be confused by such a formulation The second sentence is: "without worrying about whether your code will work on other people's computers" I find that this sentence is more of the tutorial type Finally, in your version the Autotools setup is mentioned as the last thing introduced by "In addition..." To me the Autotools setup is not an addition, it's the bread and butter of Hall. it's the cetral feature ! And it needs to be stated first and foremost ! I wrote a new version (attached here) but it ends up being very similar to my original one I would go ith this one or my original one, for the reasons I mentioned I hope this is not a problem =F0=9F=98=AF --00000000000016faba05a67321bc Content-Type: text/x-patch; charset="US-ASCII"; name="0001-added-a-reference-to-guile-hall-in-the-manual.patch" Content-Disposition: attachment; filename="0001-added-a-reference-to-guile-hall-in-the-manual.patch" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_kam43uoc0 RnJvbSBlM2UzY2IxNzdhYTQxMWEyNmQ5MjdlMDVlOTBkZDAwOTk2NzIxMzk5IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBBZHJpYW5vIDxjYXRvbmFub0BnbWFpbC5jb20+CkRhdGU6IE1v biwgMTggTWF5IDIwMjAgMTc6NDQ6MTUgKzAyMDAKU3ViamVjdDogW1BBVENIXSBhZGRlZCBhIHJl ZmVyZW5jZSB0byBndWlsZS1oYWxsIGluIHRoZSBtYW51YWwKCi0tLQogZG9jL3JlZi9zY2hlbWUt dXNpbmcudGV4aSB8IDI1ICsrKysrKysrKysrKysrKysrKysrKysrKy0KIDEgZmlsZSBjaGFuZ2Vk LCAyNCBpbnNlcnRpb25zKCspLCAxIGRlbGV0aW9uKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL3JlZi9z Y2hlbWUtdXNpbmcudGV4aSBiL2RvYy9yZWYvc2NoZW1lLXVzaW5nLnRleGkKaW5kZXggYWMyNjVm Y2NhLi5kNDMwZjg5ZTggMTAwNjQ0Ci0tLSBhL2RvYy9yZWYvc2NoZW1lLXVzaW5nLnRleGkKKysr IGIvZG9jL3JlZi9zY2hlbWUtdXNpbmcudGV4aQpAQCAtMjgyLDcgKzI4Miw3IEBAIFJ1biB0aGUg b3B0aW1pemVyIG9uIGEgcGllY2Ugb2YgY29kZSBhbmQgcHJpbnQgdGhlIHJlc3VsdC4KIEBkZWZm biB7UkVQTCBDb21tYW5kfSBkaXNhc3NlbWJsZSBleHAKIERpc2Fzc2VtYmxlIGEgY29tcGlsZWQg cHJvY2VkdXJlLgogQGVuZCBkZWZmbgotCisgIAogQGRlZmZuIHtSRVBMIENvbW1hbmR9IGRpc2Fz c2VtYmxlLWZpbGUgZmlsZQogRGlzYXNzZW1ibGUgYSBmaWxlLgogQGVuZCBkZWZmbgpAQCAtNzQ0 LDEwICs3NDQsMzMgQEAgdXNpbmcgYSBDUEFOLWxpa2Ugc3lzdGVtLgogQSBjb21wbGV0ZSBsaXN0 IG9mIGd1aWxkIHNjcmlwdHMgY2FuIGJlIGhhZCBieSBpbnZva2luZyBAY29kZXtndWlsZAogbGlz dH0sIG9yIHNpbXBseSBAY29kZXtndWlsZH0uCiAKK0BtZW51CisqIEhhbGw6OgorQGVuZCBtZW51 CisKKworQG5vZGUgZ3VpbGUtaGFsbAorQHN1YnNlY3Rpb24gQm9vdHN0cmFwcGluZyBwcm9qZWN0 cyBhbmQgZGlzdHJpYnV0aW5nIHRoZW0KKworVGhlcmUncyBhIHRvb2wgdGhhdCBkb2Vzbid0IGNv bWUgYnVuZGxlZCB3aXRoIEd1aWxlIGFuZCB5ZXQgY2FuIGJlIHZlcnkKK3VzZWZ1bCBpbiB5b3Vy IGRheSB0byBkYXkgZXhwZXJpZW5jZSB3aXRoIGl0LiAgVGhpcyB0b29sIGlzCitAdXJlZntodHRw czovL2dpdGxhYi5jb20vYS1zYXNzbWFubnNoYXVzZW4vZ3VpbGUtaGFsbCwgSGFsbH0uCisKK1do ZW4geW91IHN0YXJ0IGEgbmV3IHByb2plY3QsIEhhbGwgY3JlYXRlcyBhIGZvbGRlcgorY29udGFp bmluZyBhIHNjYWZmb2xkIG9mIHlvdXIgbmV3IHByb2plY3QuCitTdWNoIHNjYWZmb2xkIHdpbGwg aW5jbHVkZSB5b3VyIGJhc2ljIEF1dG90b29scyBzZXR1cCwgc28KK3lvdSBkb24ndCBoYXZlIHRv IHRha2UgY2FyZSBvZiB0aGF0IHlvdXJzZWxmCisKK1RoZSBzY2FmZm9sZCBjb250YWlucyBhIGRp cmVjdG9yeSBmb3IgeW91ciB0ZXN0cywKK2ZvciB5b3VyIGxpYnJhcmllcywgZm9yIHlvdXIgc2Ny aXB0cyBhbmQgZm9yCit5b3VyIGRvY3VtZW50YXRpb24uIFNvIHlvdSBpbW1lZGlhdGVseSBrbm93 IHdoZXJlIHRvIHB1dCB0aGUKK2ZpbGVzIHlvdSBhcmUgaGFja2luZyBvbi4KKwogCiBAbm9kZSBJ bnN0YWxsaW5nIFNpdGUgUGFja2FnZXMKIEBzZWN0aW9uIEluc3RhbGxpbmcgU2l0ZSBQYWNrYWdl cwogCisKIEBjaW5kZXggc2l0ZQogQGNpbmRleCBzaXRlIHBhdGgKIEBjaW5kZXggbG9hZCBwYXRo Ci0tIAoyLjI1LjEKCg== --00000000000016faba05a67321bc--