All of lore.kernel.org
 help / color / mirror / Atom feed
From: "Robert P. J. Day" <rpjday@crashcourse.ca>
To: Michael Opdenacker <michael.opdenacker@bootlin.com>
Cc: YP docs mailing list <docs@lists.yoctoproject.org>
Subject: Re: [docs] was there any discussion about supporting comments on online doc pages?
Date: Wed, 12 Jan 2022 06:27:13 -0500 (EST)	[thread overview]
Message-ID: <b18e4752-447e-4f3-427b-13907a6d9183@crashcourse.ca> (raw)
In-Reply-To: <88ac71ee-08ce-9b25-9893-15e456d1918f@bootlin.com>

On Wed, 12 Jan 2022, Michael Opdenacker wrote:

> On 1/12/22 12:03 PM, Robert P. J. Day wrote:
> >
> >   i haven't yet tested this myself; the idea was to support online
> > feedback strictly as off-the-cuff suggestions about a page, or
> > asking questions about something on that page, etc -- there was no
> > suggestion as to adding any of that feedback back into to the
> > official docs, other than manually and explicitly.
>
> Of course.
>
> >   in effect, this online feedback mechanism would be totally
> > divorced from the current docs preparation. is that the question
> > you were asking?
>
> Right, but it could be a valuable source of feedback. However, we
> would have to keep track of such comments, take the relevant ones
> into account, answer questions and if possible discard the
> irrelevant ones.

  all certainly true, but nothing says anyone *has* to follow the
discussions -- one could just look at it as a place where readers
could share tips and so on.

  on the other hand, it could also take the place of submitting
official bugzilla bugs, if someone just wants to leave notes like,
"hey, there's a spelling mistake", or "you forgot to mention option
'--fubar' in your list of options."

  anyway, it was just a thought.

rday


      reply	other threads:[~2022-01-12 11:27 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2022-01-12  9:42 was there any discussion about supporting comments on online doc pages? Robert P. J. Day
2022-01-12 10:52 ` [docs] " Michael Opdenacker
2022-01-12 11:03   ` Robert P. J. Day
2022-01-12 11:12     ` Michael Opdenacker
2022-01-12 11:27       ` Robert P. J. Day [this message]

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=b18e4752-447e-4f3-427b-13907a6d9183@crashcourse.ca \
    --to=rpjday@crashcourse.ca \
    --cc=docs@lists.yoctoproject.org \
    --cc=michael.opdenacker@bootlin.com \
    /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.
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.