From mboxrd@z Thu Jan 1 00:00:00 1970 From: swedebugia Subject: Re: Communication and Design at Guix Date: Wed, 09 Jan 2019 07:11:28 +0100 Message-ID: <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> References: ; <87k1jfuk26.fsf@gnu.org>; Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----5QZQEA7WDXOADW58TZMQ5YM1XEMT05" Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([209.51.188.92]:58125) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gh75U-0003k5-43 for guix-devel@gnu.org; Wed, 09 Jan 2019 01:11:37 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gh75S-00010b-Hg for guix-devel@gnu.org; Wed, 09 Jan 2019 01:11:36 -0500 In-Reply-To: ; <87k1jfuk26.fsf@gnu.org>; List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: =?ISO-8859-1?Q?Ludovic_Court=E8s?= , L p R n d n Cc: "guix-devel@gnu.org" ------5QZQEA7WDXOADW58TZMQ5YM1XEMT05 Content-Type: multipart/alternative; boundary="----4SOPZO43RYY69LO7WI9GZCJDDLFKIS" Content-Transfer-Encoding: 7bit ------4SOPZO43RYY69LO7WI9GZCJDDLFKIS Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable
"Ludovic Court=C3= =A8s" <ludo@gnu=2Eorg> skrev: (8 januari 2019 18:37:53 CET)
Hello,

L p R n d n <guix@lprndn=2Einf= o> skribis:

Aft= er taking some time learning Guix and trying to get some new packages
i= n, I wanted get involved in a slightly different way=2E I'm not good at
= programming and I think my time might be better used participating in
= tasks a little more inline with my skills=2E
The thing is that I find "= design" and "communication" (take it in a very broad
way) often a littl= e more complex and delicate to tackle in a group
project=2E This is why= I'm introducing the idea with this mail=2E

This is one= of the non-programming activities where Guix needs help so
I=E2=80=99m = glad you=E2=80=99re offering to contribute!

I think the Guix project could benefit a lot from= dealing with the
"rest of the world" and how it wants to show itself= =2E It might even help
clarify some technical decisions if needed=2E Bo= nus is that next release
will probably be 1=2E0 and that it means Guix = will get extra attention=2E

I have a few things I would like to tal= k about but, as I don't want to
force aniything on anyone, I wanted to = first have your thoughts about this and
eventually what you guix people= think would be nice to tackle on=2E (I
think I saw something about a w= iki somewhere for example etc=2E)

I=E2=80=99m not sure = we need a wiki=2E :-)

A very concrete task that could be of interes= t to you is the =E2=80=9Cname
change=E2=80=9D (a bit of a strong word) t= hat we=E2=80=99d like to implement by 1=2E0=2E
I=E2=80=99ll try to summa= rize=2E Currently we have =E2=80=9CGuix=E2=80=9D and =E2=80=9CGuixSD=E2=80= =9D, and that
confuses things: people visit the web site, they see a =E2= =80=9CGuixSD=E2=80=9D logo and
get confused because they were just looki= ng for a package manager, not a
whole distro, or they think =E2=80=9CGui= xSD=E2=80=9D is a storage device ;-), things
like that=2E

The ide= a is to bring everything under the =E2=80=9CGuix=E2=80=9D name=2E Most of = the
time, writing =E2=80=9CGuix=E2=80=9D is good enough=E2=80=94after al= l, one can run =E2=80=98guix system=E2=80=99
on a foreign distro, too=2E= When we really need to make the distinction,
for instance in the manua= l, we would write =E2=80=9CGuix System=E2=80=9D to designate
what we cur= rently call =E2=80=9CGuixSD=E2=80=9D=2E

This has implications mostly= on the web site and on the manual=2E Ricardo
sketched web site modific= ations here:

https://lists=2Egnu=2Eorg/archive/html/gui= x-devel/2018-01/msg00300=2Ehtml

It would probably have further i= mplications on how we present
Guix/GuixSD=2E

WDYT?

By the way, I wanted to start wo= rking on the documentation=2E
IMHO, it might benefit from a little gra= phical enhancement for
newcomers=2E The thing is that it's currently ho= sted on
gnu=2Eorg so it's probably not possible to modify the design=2E= So I wanted
to ask, first, if that's something that would be welcome? = What could be
the possibilities? And what would be the technical limita= tions?

The HTML pages at gnu=2Eorg/s/guix/manual are ge= nerated from Texinfo=2E The
CSS there is shared with all the GNU manual= s, which is nice for
consistency=2E Ideally modifications of the CSS wo= uld be submitted to the
GNU webmaster or bug-gnulib@gnu=2Eorg (I forgot = which one)=2E However, be
aware that you may encounter misplaced conser= vatism if you take that
route, so don=E2=80=99t lose your hair on it=2E<= br>
Thanks,
Ludo=E2=80=99=2E


What about guix=2Einfo? We can do whatever we want there I suppos= e and just link to it from the gnu site=2E

Talking about CSS and the manual I would like to add patens highlighting= =2E
The chicken documentation has this (on mouse over) and it is really nice t= o be able to see how complicated expressions are composed=2E

Also it would be really nice with a guix style guide apart from the manual= and a script to go through the code and autodocument from all the docstrin= gs=2E
(In the repl ,apropos can do a little something like this) I got this idea= from php reading the code of dolibarr=2E
I'm mentioning this because it is important to know what procedures ar= e where in our code for new contributors=2E
--
Sent from my p=E2=89=A1p for Android=2E
------4SOPZO43RYY69LO7WI9GZCJDDLFKIS Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable "Ludovic Court=C3=A8s" skrev: (8 januari 2019 18:37:53 CET= ) >Hello, > >L p R n d n skribis: > >> After taking some time learning Guix and trying to get some new >packages >> in, I wanted get involved in a slightly different way=2E I'm not good >at >> programming and I think my time might be better used participating in >> tasks a little more inline with my skills=2E >> The thing is that I find "design" and "communication" (take it in a >very broad >> way) often a little more complex and delicate to tackle in a group >> project=2E This is why I'm introducing the idea with this mail=2E > >This is one of the non-programming activities where Guix needs help so >I=E2=80=99m glad you=E2=80=99re offering to contribute! > >> I think the Guix project could benefit a lot from dealing with the >> "rest of the world" and how it wants to show itself=2E It might even >help >> clarify some technical decisions if needed=2E Bonus is that next >release >> will probably be 1=2E0 and that it means Guix will get extra attention= =2E >> >> I have a few things I would like to talk about but, as I don't want >to >> force aniything on anyone, I wanted to first have your thoughts about >this and >> eventually what you guix people think would be nice to tackle on=2E (I >> think I saw something about a wiki somewhere for example etc=2E) > >I=E2=80=99m not sure we need a wiki=2E :-) > >A very concrete task that could be of interest to you is the =E2=80=9Cnam= e >change=E2=80=9D (a bit of a strong word) that we=E2=80=99d like to implem= ent by 1=2E0=2E >I=E2=80=99ll try to summarize=2E Currently we have =E2=80=9CGuix=E2=80= =9D and =E2=80=9CGuixSD=E2=80=9D, and that >confuses things: people visit the web site, they see a =E2=80=9CGuixSD=E2= =80=9D logo >and >get confused because they were just looking for a package manager, not >a >whole distro, or they think =E2=80=9CGuixSD=E2=80=9D is a storage device = ;-), things >like that=2E > >The idea is to bring everything under the =E2=80=9CGuix=E2=80=9D name=2E = Most of the >time, writing =E2=80=9CGuix=E2=80=9D is good enough=E2=80=94after all, on= e can run =E2=80=98guix >system=E2=80=99 >on a foreign distro, too=2E When we really need to make the distinction, >for instance in the manual, we would write =E2=80=9CGuix System=E2=80=9D = to designate >what we currently call =E2=80=9CGuixSD=E2=80=9D=2E > >This has implications mostly on the web site and on the manual=2E=20 >Ricardo >sketched web site modifications here: > > https://lists=2Egnu=2Eorg/archive/html/guix-devel/2018-01/msg00300=2Eht= ml > >It would probably have further implications on how we present >Guix/GuixSD=2E > >WDYT? > >> By the way, I wanted to start working on the documentation=2E=20 >> IMHO, it might benefit from a little graphical enhancement for >> newcomers=2E The thing is that it's currently hosted on >> gnu=2Eorg so it's probably not possible to modify the design=2E So I >wanted >> to ask, first, if that's something that would be welcome? What could >be >> the possibilities? And what would be the technical limitations? > >The HTML pages at gnu=2Eorg/s/guix/manual are generated from Texinfo=2E= =20 >The >CSS there is shared with all the GNU manuals, which is nice for >consistency=2E Ideally modifications of the CSS would be submitted to >the >GNU webmaster or bug-gnulib@gnu=2Eorg (I forgot which one)=2E However, b= e >aware that you may encounter misplaced conservatism if you take that >route, so don=E2=80=99t lose your hair on it=2E > >Thanks, >Ludo=E2=80=99=2E What about guix=2Einfo? We can do whatever we want there I suppose and jus= t link to it from the gnu site=2E Talking about CSS and the manual I would like to add patens highlighting= =2E The chicken documentation has this (on mouse over) and it is really nice t= o be able to see how complicated expressions are composed=2E Also it would be really nice with a guix style guide apart from the manual= and a script to go through the code and autodocument from all the docstrin= gs=2E (In the repl ,apropos can do a little something like this) I got this idea= from php reading the code of dolibarr=2E I'm mentioning this because it is important to know what procedures are wh= ere in our code for new contributors=2E --=20 Sent from my p=E2=89=A1p for Android=2E ------4SOPZO43RYY69LO7WI9GZCJDDLFKIS-- ------5QZQEA7WDXOADW58TZMQ5YM1XEMT05 Content-Type: application/pgp-keys; name="pEpkey.asc" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="pEpkey.asc"; size=3825 LS0tLS1CRUdJTiBQR1AgUFVCTElDIEtFWSBCTE9DSy0tLS0tCgptUUlOQkZ3Y25XMEJFQURhNWti U0t0ZEd6ZzQ1SjZkQnRFS21lZFM2bEtEQkx1UmlNZTRTNHppTFVMaVV5RTlWCmVNeTA0TUUzbFN6 WHg4TlpSNjVxSzdENDRhVlRvV29iUlcxMEhGWi9YOWh5bFlrcnFzUk45cndieW5mOTFrcU0KcVI2 TkRxQjJKRHZTek9LRzM0U2dnTzVkVGh1RE1GdzNmT3Z1cGhtSnN5b2s3OGVYQlFqTkxyaXNvQnhT SEFyVgpzZjdIMlJIYlNmTmZaclMxaEtUUzRtbFBpNnJZS2ZFMUFvbm8wdUs5SnVVZHBTTyswODdV ejhRam5GVTE5c09BClJWTWtUTnpuZk12MHVzeUsxSzc5U2pjYzJjTzhkNDRUalJlTGkxcFlHMjBV OHhtQXBpRlJhRXhaOHlyR3c5RTkKYm9CcVo2TUZoNjhQWFNQa0ZjMWhTQ3BUV0xVZW1ZdEFrMkpE RHo4R1EwYWNRNU1aMlRJSzZJR0RCaEw4b0xCNwo2anZOMlBVYUN3VmFDYUNwS1JncU9Fd2dvdDBr MlFZRnZkODZUM0kwYVVNMDkzYVZ6aWdmUnYzaDlaMFhINytUCmZickhxalMrUlZTcjVKYytVeGox KzlqWEFQeEllVmRqMWpIOXE2ejJ2Z3UzSHRpaXlsQUp4SlFhUFFEZkhHQzEKNm9HODBwd3JoWWFj Q3JPT2QxUWhwZzhSOUlsaUQ4bU85WERTcHZoNGo2UFpXY1F6YWRYOFl5b3Z0UDNLS1B1dQpUM0h0 UDRmcXJhVmIzV2p2Si9ST0E3aTd5UHhGMTk4TExyKy9kMC9uamEvZHlWTjNHam1BellaL2dnZTdW aHp1CmZ2SFNGNFdLWWRFWFZWZzBhRjFVZ2FyTW1BaTUyNlhzTm1QRDU4cHdwc2hjL1F5SkV5Znlq ZnJuVndBUkFRQUIKdENKemQyVmtaV0oxWjJsaElEeHpkMlZrWldKMVoybGhRSEpwYzJWMWNDNXVa WFEraVFJK0JCTUJDQUFvQlFKYwpISjF0QWhzdkJRa0I0VE9BQndzSkNBY0RBZ0VHRlFnQ0NRb0xB eFlDQVFJZUFRSVhnQUFLQ1JBWWdFY1UxcWYyCjIwOGhEL29EcktQOTJIRDdKbVdWd0FKTkF6Qzh5 aW4wLzllVFJKb05XaXNjd2IrMG9hOVhzdXFwTktZNjdiWHgKamxUZmwxZSsvSmM2ZEoxTmR3cDVm Vk5FTmxhYmMxcnU0L3BQVk5PaXJOVjMrZFRYTU5ISEZkeHhRRWxENFhLYwowTmxLN0ZrUWxCdmNR ay94cmlQR1JuZEx4MmtZeVRFSStLcTRVdWNiZnVkT1YzaFJmOExaWVY3SzZEcTlWM2l2CmY4OWJV Q3lQRjhoZGN1czJBMnJvUU5NWUdLK2FPTGFWRzJYVnM1QS9DZFA3UEh2Yzk5TjY4a2xYbHZ5ZU1Y NGYKdG1FUFhOcnBsVElxQm5PbHdHZkN3QUY2OHIvVlVxcjNzek5OV3hDTk1sTmdORnA4ZmpKdjVx S3hnMkpzbGU4awppb0RYcUtJaWtISDBQTXJ2Nm5xNHEwbU96M2N5VkEwclpCS2E0WVhlTEhINDVm T1N5Yit3aStqSUJDaTlsQms2ClM1c2Y4dGVmd0hIaS9GNGZEZVI2NXdlSmhZTVpWRHlZS1NwKytx b2NFMHQ4NVFjOGdKS0pqQmRWQ3IwTTcrVWwKeGtybjBUQzRSelc4ck5ZQ2FiYWZxenVuRmplcmxG TDRXWnVNS2ZNNXFkUUxRUTFLZWJleTN2TlB3M2xUZ21VcgpLb2hmVXpKcmhmMkFNdXdQWjl6N1Vl WVZVSHNOS2Q2aTk2eGpkZHZFTkprOExlUDZHM3QrR3RSNWExWTRDdnk1CnVPcXpVczlUSnlXM3dj ejFYSkI0TS9UUkt6aDJaZWNHSUNSM2lPb1AxRHlZUlpuZ0ZSQ0FiOEQ1ZFAvWTdSM0YKYmNIeDR4 NHQ2a2Z3K0VVZituS2tKNzhPTHJOUVhiNlR1a3RiZy8wSWRCN2NNeWcwc2JrQ0RRUmNISjF0QVJB QQp1K2c3K2Y0VnJub3pwRGJzejNsRXAzZ1NtS3BmUFl2WXdTK0h3VTZEQm4vblVaNmVIUGRvcXcv RUE4bFl1OFkyCmhHY2ZGKzRxZUxmWEptWEg2SC9RVXdTNU1QTjZLcnJzUnVKU083OFR3UWRNUmtB RzJVbktrT3YrM2hRbk9LTG8KMmFySTVzNDZRbk0ya0JMN3lIM0t3N3ArUEFyT0JUOSs1alN2V0FM dUFvMWNpNCsybTR2cmhha05wR0NFcFhZNQpjcG9MYnlrQlNOMGwwTVFrYnZ0UHE1RmJpb1pRclpF MUVQQ2ZLdU1Ld25vL3pWcDBtbWNpZmluSEdENVVodENoCmt5VUoxaUxnMTdLZlo0eXNOMmVWOHFx YklqbWRnN00wRlVWMHhodGY3S1FpWFo2K1k1YWpBSi9BVHVYQUs3T2YKak1JdG50TzltSnBsQ0JH Y3VRbERtd1JpaHVQTjkrczVrak0rcTdTUENzNDFxREdNaXp2ZnVuSk1LblJMQmRNUApsS0NMNWhE QWhDSHRyTzhqSnJNS1lWcnkyemRkT1VhK1FmOFNwNFRjTVhaMjN4d1hqU3B5UkpDUU9ibG5DaUkv ClI0NUpsZERsYm42V29UZWlzUThJSTE1cnlibEtPeDVwdlk2VC9QQ1hxWW9nSENxSmJwVXNiMitU b29uZHU5Z0kKSENDSFFUZUhET3J3UGFheVZCSWcyNjhOUEZFalJza2hnOFg1a0FpZTZWYTNOajR6 elpmdk93ektpQjVDZktnbgpJaTgvbTN5QnZwZ2ZDK1RSQWMrdmhDYWEvejBTQU5UTXJjMzhLd0Vu ZmNJSG9Mek9JZzEvS0dWNlpnUzRmYVFECjlWeGswT0NNL3JscHZCT3ptNjJ5bzcxZWtzOUUrQTd1 L3pOOWdWZ0JHaFVBRVFFQUFZa0VSQVFZQVFnQUR3VUMKWEJ5ZGJRSWJMZ1VKQWVFemdBSXBDUkFZ Z0VjVTFxZjIyOEZkSUFRWkFRZ0FCZ1VDWEJ5ZGJRQUtDUkFCUEtQZwpwcWRNTFdweEQvNG0zLy8z MVAvS0JkZlJtTkk3UVV4akN5WVhibDBOYUpiT1NrUWMvRjk4TDlabk9FaGR2dU0zCmpoM1hrWW16 WWZmT21RMWV1TFppV1N2bEk5WWhSU1N1dmI0dVhtR1JVVGJZbVdMRVNaQmF3bElPNW1rT3h6cTQK cU5oK0UrTW4wZDFBSkw3cHVUd2RETDFPVXBML3hZUUFYVzF3bS9HOTcrOHQ2WVhkdTd4SG5uaHpE UmpIMUVDTQpPOXZ3YXp3V2tEUjdTc1Y2MHI1blhNcUw5dDhxZDJpRTRqNVFISXljTkxnSGsrSmIw QmxMclAvNHphcDFNNFNOCk0xMk4vSlZ0LzZ3ancrNk5KS0ZldE1OcG9Ic3pxOC80K0w2cEEzOUdP VkxYY3dmZzQ0T0JxRHRsUTlFVFF4VGMKV0JCSTg3ZVlNQU9Db3QyQlF2Rms5aENZRFJlQ2NFckxF YmsxV0RtWTNHcyswZDIrQnRSNmNEYnZHSWlaSDEvVQp3Mnc3eVJaMWgvenNYYWpva2tJM2ljTXhh VGVlVVJCSUNjOFBESWNVS0EzemVsdThuS25pUmZscUE3dGNtMHV2CktGSjVjS0JUa3N6RWdNb2x2 cUR6VWlhUkdyeko2R2grMTV1bHc2NTd4SnRTUkZ4Y3RpN3hENnlkUmt1VkFqSmgKVHRqTCtOZEtm VXl6ZFJCQlhoaFppTklsLzgxSkZ1b2ZJLzhLN1NvODRKb0h6V1JDbVVsdVladXMvdWFkalBkSApQ TXRySnZqKys1a01vYjV4OEg0eHIwdHA0Q0Y4TWo1VkRyYitiU0NsMFBOU2xaQVdUVkJDTm92QlZp MUVod0daCnRUMXNNU3dsblgrRjlxbERhdVBzVEhvb1NYRkVvU21lZmwrQ3VCZDZ0WG44eGFpZWhE NHNQMzJBRC80eGxkWWQKczhSM0haTTBIOGo2akFmRUgwbmY2NnoySXZ0cEE3eDdyVGVNd21IVFNK NjIvVUxiVXdJeUZYWkxWSTVSSVJmYgp4cVNBb3NIbklhVktlanBUMXgyN0t2bEREQ3ZUTnVnMUxR OEozSU05U1pqOVNTV005RjZFMjh2SGt1ejNEMGpYCmpmL0ZHMEQvelhlTFFleVE3cWZ3KzUxUzR3 YUZHT0dwNitOOGRJL2FuQTdaR0ZpMmFjd2FVUENBZ1hvc2pienYKMkRzdVgvZGFMS0FLSWxNMXYx akVob0ttblRPYXk3SGtTbFZCT29TWWRYeG55cUN3SkI2bE42dm45ZzBCQ2M0NQo2U1pObXdkZW1K bXdLQlJjV2phWStZY2c0UUg5WUxGdHZjYlZwVDNsOU1rVkxYWGxiM2xXZE5vbDliaTJSY2kvCkJs dGZVY1RnVHhTS0lQWTBpd2J0SXVRSU4rTVBPbGtVZ1lKY1JIRlFWamhZTW9iMk16MHpjRjRTazdW elRTQmYKbzFvTlUzcGRDTDVTNXkyM2ZqWGc1dkk4QmtLTmt6OVV1ZUlJSzE2WnZ4RjBaaUorYWtm SjZGbGpVc044S1ZyNgo1T2w5akdraXQ1b01ZZUpmeXptZ2tudEExaS9MVWVDZG94d0l2cUprZSs4 VmxWMURzNnFUTVc2ZUh3NEwvSTltCmhsZG5nK2Q3eWJQbXFtL0FRZFhXZVR3aFpiRG81MU1XQW84 SFJPK0pIMEdXRmVLOFdpRWJTbFB2MFBrWG83cDIKUTVvcUpkc0p5cDlwNjlYOGpvQjFxQm9MczJ1 RWJRWFM5MnJJVHFEVDYybVFZdTNQQ09kTzdBOGdqWUpDSENndgpZQWpWUjcrRWlJM0gyVXVWWjBT aVVwS0ZuZXhzdEthcm9Id1dTZz09Cj1iV1RRCi0tLS0tRU5EIFBHUCBQVUJMSUMgS0VZIEJMT0NL LS0tLS0K ------5QZQEA7WDXOADW58TZMQ5YM1XEMT05--