Re: [PATCH] doc: Improve wording and fix typos in "Introduction" and "Requirements".

[Ludovic Courtès]

Nikita Karetnikov <address@hidden> skribis:

>> “Consists of” may be OK (any native speaker around, though?).
>
> "Consist in" means "To have the thing mentioned as the only or most
> important part." [1]  "Consist of" is usually about several things [2],
> AFAICT.
>
> Which one should I use?

“Consists of” appears to be the correct one (thanks, Alex ;-)).

>> “Preserving” instead of “honoring” changes the meaning.  The intended
>> meaning of the sentence was that the system would automatically install
>> any dependencies, or, if building from source, install any build time
>> dependencies.  What did you mean?
>
> I meant the same.  Should I keep "honoring"?

I would say so (though again, I’m not a native speaker.)

(Feel free to commit a revised patch that takes into account this
discussion.)

>> Actually, documentation-wise, my wish would be for people to primarily
>> focus on those parts of the manual that are *not* written yet.  :-)
>
> Which parts would you like to see documented before the next release?

The “GNU Distribution” section could be improved.  For instance, the
bits about bootstrapping from the ELS paper could be incorporated
somehow, because I think it’s an interesting topic, and a distinguishing
feature as well.  Also bits about the API, in particular ‘build-system’
objects.

WDYT?

Thanks,
Ludo’.