From mboxrd@z Thu Jan 1 00:00:00 1970 From: swedebugia Subject: Re: Communication and Design at Guix Date: Thu, 10 Jan 2019 14:20:06 +0100 Message-ID: <309F9FF7-FE89-4935-9D08-ECC62937D95F@pretty.Easy.privacy> References: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> <877efd1p56.fsf@gnu.org>; ; Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="----BNE0F3GNV3M11RETQCGBH32NBC3KIH" Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([209.51.188.92]:45845) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ghaFo-00022M-HJ for guix-devel@gnu.org; Thu, 10 Jan 2019 08:20:13 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ghaFn-0001Ol-L6 for guix-devel@gnu.org; Thu, 10 Jan 2019 08:20:12 -0500 Received: from mx1.riseup.net ([198.252.153.129]:33780) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ghaFn-0001OU-7O for guix-devel@gnu.org; Thu, 10 Jan 2019 08:20:11 -0500 In-Reply-To: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> <877efd1p56.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: L p R n d n , "guix-devel@gnu.org" ------BNE0F3GNV3M11RETQCGBH32NBC3KIH Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=UTF-8 L p R n d n skrev: (10 januari 2019 13:09:48 CET) >Hello, > >Ludovic Court=C3=A8s writes: > >> Hi swedebugia, >> >> swedebugia skribis: >> >>>>> 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= , >be >>>>aware that you may encounter misplaced conservatism if you take that >>>>route, so don=E2=80=99t lose your hair on it=2E >> >> [=2E=2E=2E] >> >>> What about guix=2Einfo? We can do whatever we want there I suppose and >just link >>> to it from the gnu site=2E >> >> Well in general we can always do whatever we want=2E :-) I do think >> there=E2=80=99s value in presenting GNU manuals in a consistent way, th= ough, >> especially since Guix=E2=80=99 manual has cross-references to many othe= r >> manuals=2E > >That would be nice though=2E Even if consistency is enjoyable, I think >the benefits of a nicely shaped and organised documentation easily beat >what we could get from being consistent with non-Guix manuals=2E IMHO=20 >GNU manuals are ok when you know what you're searching for, I find them >unreadable=2E + I think they're intimidating for newcomers=2E :/ =20 I agree with you to some degree=2E I like the design of both the racket d= ocumentation and readthedocs=2E Especially the left menu gives a nice overv= iew and searchability on page is also nice=2E --=20 Sent from my p=E2=89=A1p for Android=2E ------BNE0F3GNV3M11RETQCGBH32NBC3KIH 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 ------BNE0F3GNV3M11RETQCGBH32NBC3KIH--