[bug#42516] [PATCH] doc: Extend tlp-service-type example.

[Tobias Geerinckx-Rice via Guix-patches via <guix-patches@gnu.org>]

[-- Attachment #1: Type: text/plain, Size: 1368 bytes --]

Brett,

Brett Gilio 写道：
>> -The service type for the TLP tool.  Its value should be a 
>> valid
>> -TLP configuration (see below).  To use the default settings, 
>> simply
>> -write:
>> +The service type for the TLP tool.  The default settings are 
>> optimised
>> +for battery life on most systems, but you can tweak them to 
>> your heart's
>> +content by passing a valid @code{tlp-configuration} as its 
>> value:

[…]

> I would replace "as its value:" with "to the service type:", so 
> it reads
> "... but you can tweak them to your heart's content by passing a 
> valid
> tlp-configuration to the service type:"

Ding.  You picked up on the same niggle that bugged me — both in 
the original & here.  I thought I'd just stared at it for too 
long.

‘Value’ is a reference to the terminology used in (gnu services). 
‘To the service type’ sounds less accurate.  I find the sentence 
close to clunky is it is; what about a short and sweet:

+The service type for the TLP tool.  The default settings are 
optimised
+for battery life on most systems, but you can tweak them to your 
heart's
+content by adding a valid @code{tlp-configuration}:
            ^^^^^^

Now I've definitely stared at this for too long.  How typical for 
a prose patch :-)

> Otherwise, it looks great to me!

Thanks,

T G-R

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 227 bytes --]