all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Quiliro Ordonez <quiliro@riseup.net>
To: help-guix@gnu.org
Subject: using questions to enrich documentation
Date: Mon, 29 Oct 2018 13:34:45 -0700	[thread overview]
Message-ID: <fcd495c615d4482f48fe6be2b6de04f2@riseup.net> (raw)

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)

                 reply	other threads:[~2018-10-29 20:34 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=fcd495c615d4482f48fe6be2b6de04f2@riseup.net \
    --to=quiliro@riseup.net \
    --cc=help-guix@gnu.org \
    --cc=quiliro@fsfla.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/guix.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.