On Fri, Dec 07, 2018 at 02:56:03PM +1100, Ross L Richardson wrote:
> 
> Whilst I agree with Otto (and others), how about making it really simple
> by avoiding technical terms?
> 
> Ross
> ----
> 
> Index: ifstated.conf.5
> ===================================================================
> RCS file: /cvs/src/usr.sbin/ifstated/ifstated.conf.5,v
> retrieving revision 1.13
> diff -u -p -r1.13 ifstated.conf.5
> --- ifstated.conf.5   18 Jun 2018 06:04:25 -0000      1.13
> +++ ifstated.conf.5   7 Dec 2018 02:59:43 -0000
> @@ -90,7 +90,8 @@ interfaces this equals the init state.
>  .Pp
>  In contrast to link state tests, external tests must be run periodically to
>  evaluate their status.
> -The frequency at which an external test is run has to be set with the
> +The interval in seconds between (starts of) runs of an external test is set
> +with the
>  .Ar every
>  keyword.
>  .Pp
> 

morning.

i'm afraid i think this reads quite poorly - it is hard to actually
understand what is meant.

here's the thing - someone has already written the text. if we want to
change the author's text, i think we need to demonstrate that their text
is wrong, inaccurate, or somehow misleading.

so far, i don;t believe anyone has done this. so i am reluctant to
change the author's words.

in the case of your original submission - the detail about seconds - i
am happy to change things. because there was relevant information
missing.

i think we are wasting time fixing nothing. can't we just add "in
seconds" and get on with it?

jmc

Reply via email to