From mboxrd@z Thu Jan 1 00:00:00 1970 From: Giovanni Biscuolo Subject: Re: Communication and Design at Guix Date: Wed, 16 Jan 2019 12:00:27 +0100 Message-ID: <87k1j4x3xw.fsf@roquette.mug.biscuolo.net> References: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> <877efd1p56.fsf@gnu.org> <87r2dk4m4g.fsf@elephly.net> <87k1j81bau.fsf@gnu.org> <32DFF401-F4E7-4B98-A8B2-DC9A321500D7@disroot.org> <87k1j5ing2.fsf@elephly.net> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([209.51.188.92]:37901) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gjiwB-0002q4-LZ for guix-devel@gnu.org; Wed, 16 Jan 2019 06:00:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gjiw8-0007aw-M7 for guix-devel@gnu.org; Wed, 16 Jan 2019 06:00:46 -0500 Received: from ns13.heimat.it ([46.4.214.66]:35278) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gjiw5-0007P8-UY for guix-devel@gnu.org; Wed, 16 Jan 2019 06:00:44 -0500 In-Reply-To: <87k1j5ing2.fsf@elephly.net> 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: Ricardo Wurmus , nly Cc: Guix Devel , L p R n d n --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hi all, I'm not an expert on "hot to write a reference manual" but I like how the content is organized in Guix manual and I'd like that all Guix documentation will remain a coherent set Ricardo Wurmus writes: > nly writes: > >> continuing with the emacs example, a guixwiki.org would be awesome as >> an analog for emacswiki.org. User maintained, quick and short examples >> with lots of supporting links. > > Hmm, I have the opposite opinion. I find the emacswiki to be a great > example for what=E2=80=99s wrong with wikis :) i agree with Ricardo verbatim with all due respect to people involved, I find emacswiki one of the worst source of information and documentation on Emacs: all is scattered across many pages and hardly I (an emacs newbie) found valuable information - most outdated - there speaking of content organization, we should take inspiration from https://www.gnu.org/software/emacs/manual/index.html [1] obviously there is always space for *presentation* enhancements (CSS and alike) but that's another story [...] > I would welcome patches that add a new cookbook document. ...or a FAQ document should we start a documentation-wishlist.org in maintenance/doc? (I'm still not sufficiently skilled to help with content, but can help keep such todo-lists) [...] happy hacking! Giovanni [1] AFAIK each documented mode or package is part of the official Emacs distribution while external packages are not documented =2D-=20 Giovanni Biscuolo Xelera IT Infrastructures --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEERcxjuFJYydVfNLI5030Op87MORIFAlw/DswACgkQ030Op87M ORLZgw/+Ohg6AfWC9ejfHc2vxHjsrFyzOJFB+ryUUZji4tbpY3OLx/r/Et7wwfY7 pYoL4MsGeUfLwViscyWEQm+58f4WWnTr6CJnjq2BpMN6ZxX+byJVMlMoTTCzBse1 oSwNNTW63C+LRCWNCMRIXqSzev/2tY5qvfklUqtx8U6v82qHBG+TJa7U05LhXvmI +CuuJdyx0KrYjKqlyxEU30Ju+bNo9CUD6ZyUdzvyJTGt7x1dZJmw8Od4vpoiBXgb LEBa+KyooRdp9u6vOzFHfHqXovPtQloig9Fa9zJO4oQcK3lKO7b/TVSHPL7vdEBp 1NtfHXMU25yQRcizTcj169tWnEa3OBL17aOroorEQ8Js6Zt//J0PEdm6tv7O6iXP bNoRw2nfaitvl8mbIzqdDwFVqdR1a2fpHk02tp+TGUbgYcGbyzk89fJPaz7kYF4Y KCgY7Xa4Zh/AZtURuYSSuuMYoqdnao464ZvENkSqUrRb1sB61CfrB5xx3KUhi5sT xWQbrcmJGfi9vG0k+qKVU+XgX0OC1hOhnHUOdC+4hppERr4BsAm+IgiJY5l6AAUU uYsU/QrKEZdd4mvlzW3Ur6g8PpJyx1DRXl3CQzK2mxgZ4a2dW3NlDgwzxSdsZO0o H7ltR/3V13nnIkD+dE8o82AD0KCw11n2ZBTEH/+vP2YZrB9KS60= =Kl3L -----END PGP SIGNATURE----- --=-=-=--