From mboxrd@z Thu Jan 1 00:00:00 1970 From: Quiliro Ordonez Subject: using questions to enrich documentation Date: Mon, 29 Oct 2018 13:34:45 -0700 Message-ID: Reply-To: quiliro@fsfla.org Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:58838) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1gHEFO-0003Ig-3P for help-guix@gnu.org; Mon, 29 Oct 2018 16:34:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1gHEFK-0007lf-SS for help-guix@gnu.org; Mon, 29 Oct 2018 16:34:50 -0400 Received: from mx1.riseup.net ([198.252.153.129]:60133) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1gHEFK-0007lB-J0 for help-guix@gnu.org; Mon, 29 Oct 2018 16:34:46 -0400 Received: from cotinga.riseup.net (cotinga-pn.riseup.net [10.0.1.164]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (Client CN "*.riseup.net", Issuer "COMODO RSA Domain Validation Secure Server CA" (verified OK)) by mx1.riseup.net (Postfix) with ESMTPS id 99A011A04F3 for ; Mon, 29 Oct 2018 13:34:45 -0700 (PDT) Received: from [127.0.0.1] (localhost [127.0.0.1]) by cotinga.riseup.net with ESMTPSA id 5C9BC100D0B for ; Mon, 29 Oct 2018 13:34:45 -0700 (PDT) List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane.org@gnu.org Sender: "Help-Guix" To: help-guix@gnu.org I am currently reading the manual from start to finish, linearly. I have about 40 questions and observation at 40% of the text read. I will send them to this list when I am done (or when you people regard it as best). But I think I would like those questions to enrich the docs. Here is my take for all queries by newbies: When a question is asked on forum, mailing list, chat or elsewhere, it would enrich the documentation enormously if the answer would cite the documentation rather than if the answer was a new text. If the documentation were not clear enough, it would be more productive to correct the text and cite it on the support area instead of just guiding that single user. that would make the docs avoid a little of the double work of support. The other option is that the user who asks the question would be instructed on how to complement and supplement the docs. That would also be a way to involve users to learn to contribute. What do you think? (WDYT)