all messages for Guix-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
From: Andreas Enge <andreas@enge.fr>
To: "Ludovic Courtès" <ludo@gnu.org>
Cc: guix-devel@gnu.org
Subject: Re: 01/01: doc: Typos and small stylistic changes.
Date: Sun, 6 Mar 2016 17:02:41 +0100	[thread overview]
Message-ID: <20160306160241.GA17356@solar> (raw)
In-Reply-To: <877fhg38b2.fsf@gnu.org>

On Sat, Mar 05, 2016 at 10:48:33PM +0100, Ludovic Courtès wrote:
> This commit modifies some of the service documentation, which is also
> available in docstrings in gnu/services/*.scm.  Could you update them
> accordingly?

Finally, I think this is unreasonable. I already spent 20 minutes just
trying to organise a work-flow: Some of the strings in the manual are
taken from docstrings (I think the procedures), others are not (I think
the variables and data types).

Altogether, I think I would spend an hour updating comments in the source
code, together with writing detailed commit messages.

If you think it is important that both match, please just revert my patch
(and I will not be offended); I did not make important changes anyway.
I do not have the energy right now to wade through the docstrings. Instead,
I would rather investigate things around installation that I wanted to
look at.

Andreas

  parent reply	other threads:[~2016-03-06 16:03 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
     [not found] <20160305152745.10002.35086@vcs.savannah.gnu.org>
     [not found] ` <E1acE7O-0002cK-0Z@vcs.savannah.gnu.org>
2016-03-05 21:48   ` 01/01: doc: Typos and small stylistic changes Ludovic Courtès
2016-03-06 13:10     ` Andreas Enge
2016-03-06 13:46       ` Mathieu Lirzin
2016-03-06 15:26         ` Andreas Enge
2016-03-06 19:13           ` Mathieu Lirzin
2016-03-06 23:10       ` Ludovic Courtès
2016-03-06 16:02     ` Andreas Enge [this message]
2016-03-09  9:02   ` Alex Kost
2016-03-11 14:19     ` Ludovic Courtès
2016-03-14 19:58     ` Andreas Enge
2016-03-15 16:20       ` Ludovic Courtès

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=20160306160241.GA17356@solar \
    --to=andreas@enge.fr \
    --cc=guix-devel@gnu.org \
    --cc=ludo@gnu.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.