From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Zelphir Kaltstahl Newsgroups: gmane.lisp.guile.user Subject: Re: Starting a GNU Guile awesome list Date: Tue, 14 Jul 2020 23:23:40 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="39455"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 Cc: Guile User To: Dmitry Alexandrov Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Tue Jul 14 23:23:59 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 1jvSP9-000A87-3G for guile-user@m.gmane-mx.org; Tue, 14 Jul 2020 23:23:59 +0200 Original-Received: from localhost ([::1]:56960 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jvSP8-0002bv-61 for guile-user@m.gmane-mx.org; Tue, 14 Jul 2020 17:23:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59070) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jvSOy-0002bh-B1 for guile-user@gnu.org; Tue, 14 Jul 2020 17:23:48 -0400 Original-Received: from mout01.posteo.de ([185.67.36.65]:46321) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jvSOv-0008KZ-1Q for guile-user@gnu.org; Tue, 14 Jul 2020 17:23:48 -0400 Original-Received: from submission (posteo.de [89.146.220.130]) by mout01.posteo.de (Postfix) with ESMTPS id 8F18016005C for ; Tue, 14 Jul 2020 23:23:41 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.de; s=2017; t=1594761821; bh=jTVlgyMiLQcaBaeyTJnbs/jnDGVUHMxJFekU0wWMOMM=; h=Subject:To:Cc:From:Date:From; b=CyJnBjni2zc5dH6GbB3594bIDN7O+bsrWiXdf9PeDEYGNcyNG3nkwzQmjnq8gldRa Xvm9y58NUs9XRSrUr2lhrCRsHS9CFfLcktUWZCPMzgpdwH7o6IanMV8UjRNjlFPCqs O6254xz0MVz5+rR5a4mDWIq1WKAWm3mJ2eTARz7tHvJWv2W1qJWSLmXG/KHKHm/+Eg nk38bMEC7aCtW3wopIF41VIj+GKsNIxW6pgUNLfNvxYEehFsFvq07g8IMYwc7p502d uXPMoQqn/tJ7fcKznWBHe78O4JRt7QjmuFkfeJAe2UnUz5SRtm+o9DlWLLWkPLDnLs s9HR3bRmYkp+w== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4B5tmX6cmRz6tmQ; Tue, 14 Jul 2020 23:23:40 +0200 (CEST) In-Reply-To: Content-Language: en-US Received-SPF: pass client-ip=185.67.36.65; envelope-from=zelphirkaltstahl@posteo.de; helo=mout01.posteo.de X-detected-operating-system: by eggs.gnu.org: First seen = 2020/07/14 17:23:41 X-ACL-Warn: Detected OS = Linux 3.11 and newer X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.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, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action 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:16688 Archived-At: Hi Dmitry! On 7/14/20 11:00 AM, Dmitry Alexandrov wrote: > Zelphir Kaltstahl wrote: >> I ‹…› started creating an awesome list >> https://notabug.org/ZelphirKaltstahl/awesome-guile > +1! > > However, even if you are not going to apply for inclusion¹ in meta-list and therefore are free from complying with all rules that might come to the mind of a macboy in state of administrative ecstasy²; calling your list ‘an awesome list’ implies a certain format nonetheless. > > And that format actually answers two of the there of your questions. Thanks for informing and mentioning those things! I did not even know. > - > ¹ In any case, I am not sure, whether they accept lists with the primary repository outside of github.com at all. I'm surely not going to create any repositories on GitHub in the near future, unless somehow MS becomes the new saint of the free software movement ; ) > ² E. g., recently he had broken local clones and invalidated all the pull-request backlog by renaming ‘master’ branch to ‘main’, and now require all the lists to follow his example. Ha, the whole thing about renaming master branch sounds so silly to me, I'd never do that. Perhaps that person got too much time or something. I wonder, can people even still get a "master degree" or write a "master thesis"? Can I still write my master degree on my CV or is it now shameful? >> * Do you think each item should have a short description or not? > Thatʼs the key feature of ‘awesome lists’, number one in the ‘manifesto’ [1]: > > | Comment on why something is awesome > | > | Apart from suggesting a particular item on your list, you should also inform your readers why it's on the list and how they will benefit from it. > > [1] https://github.com/sindresorhus/awesome/blob/main/awesome.md OK, it can be useful. I'll see, when and if I can get around to writing the descriptions. The thing is: For some modules / packages / libraries I don't even know how to describe them correctly and would need the authors' help or quote their texts. It would be nice, if people sharing adding Guile things to the list gave short descriptions, if able to do so. >> * Do you think the rendered readme.md should be handwritten instead of exported from org-mode? > Again, ‘awesome list’ format implies [2] Markdown as a source format. Nobody says, though, that a source is something handtyped. > > [2] https://github.com/sindresorhus/awesome/blob/main/pull_request_template.md To me this awesome list thing seemed like an Internet software development phenomenon, which would be nice to carry into the Guile world, in order to increase discoverability. That's how I have experienced it so far. I've never even heard of https://awesome.re. I should have looked it up / researched it more, beforehand. Didn't think there was anything more to it, than creating a list inside a repository. I think their rules are theirs and we can do as we wish. I don't think anyone can claim the word "awesome" as a prefix for themselves and impose rules on how anything has to be, when having the prefix. However, I'd consider using another word instead (Why not do our own thing?), if it is consensus (What do people think about renaming the list?), that the name should be changed due to the list at https://awesome.re existing and the author of that trying to impose stuff. Possibly this comes at the cost of a little bit of discoverability. There is still "ingenious guile" :D >> (Perhaps I should not ask this question … the amount of markdown typing … my fingers hurt.) > ??? The only thing where org-mode saves typing over markdown-mode is ToC generation. But there are lots ToC helpers for Markdown! (describe-package 'markdown-toc), for instance. > > In the case you will stick with Org, there at least should be a runnable build recipe (i. e. a Makefile). I'm sorry, you are (understandably) misunderstanding me here. I was not very clear. I've been hinting at RSI, which I need to look out for, not at any advantage in number of characters or key presses to type in Markdown vs Org-mode : ) I am not even sure which one would require less typing, considering the comfort Emacs offers for org-mode. In Emacs one can easily export to Markdown from Org-mode or to many other formats. The table of contents is already generated by org-mode export. I am not sure, whether one can use Emacs functionality from outside of Emacs. I remember there being a library about Emacs stuff, possibly written in Guile. Forgot the name though. It was I think also shared on this mailing list at least once. (I should probably find it again and put it on the list!) What I will not do is discarding the org-mode file, as it is a much saner markup language and allows for many more output formats. One can write whole scientific books in org-mode, which is impossible in original Markdown (probably only possible in PandocMarkdown) and yet the syntax remains very intuitive (for example for check lists / todo lists!) and simple. The question is, whether it is worth it typing the markdown file by hand instead of exporting from org, because of how the converted file is converted and then how rendered at the git host's web interface, with Roman numbers on second level of the lists. The style of headings also does not distinguish the levels of the headings very well. The font sizes are too similar. I wish it would render org files properly, in their full glory. >> * Do you think license information should be written next to each item in the list? > First at foremost, the list _itself_ has to be licensed as a free documentation. FWIW, most of ‘awesome lists’ are under CC0. While the list is not CC0, I meant to put it under "GNU Free Documentation License v1.3", which I think should be appropriate (Is it not?) and free as in freedom. Good that you hint at the license, because I thought it had a license already. It seems I did not check the checkbox for notabug to insert that license file or I forgot in excitement of creating the list. I'll add that license as the next step. >> * Do you think license information should be written next to each item in the list? > Anyway, imho, yes, it should. This is an information with the highest usefulness/length ratio. Perhaps, only maintained-or-abandoned bit could contend for it. > > Actually, you might eventually find out useful to list something, because it has not a technical, but exactly a licensing advantage to another item. > > For instance, the above-mentioned GNU G-Golf have a advantage over Guile GI as it does not follow a bad licensing practice of distributing a glue between a library under license A and a language under license B under terms of the third license C. OK I will consider those points. Thanks! Best regards, Zelphir