Joshua Rose <joshuarose@xxxxxxx> writes: > Hi all, > > I just wanted to briefly point out that as a native English speaker I > found the following text significantly hard to read. > > "Do not worry installing your kernel manually and thus bypassing your > distribution’s packaging system will totally mess up your machine: all > parts of your kernel are easy to remove later, as files are stored in > two places only and normally identifiable by the kernel’s release > name."[1] > > I found this very hard to read. I would probably re-phrase this as > follows, but I'd be completely open - and in fact encourage - any > suggestions on the rephrasing of the excerpt. > > "Do not attempt to circumvent your distribution's packaging system by > installing your kernel manually; this will likely break your machine. > Components of your kernel can be selectively removed later on. Such > components (files) are stored in two locations, both identifiable > by the kernel's release name." I think you have completely reversed the meaning of that text - which perhaps indicates that it is indeed in need of improvement :) > As an additional note, I'm looking for any recommendations on a good > resource on the maintenance of the Documentation/ directory. Documentation/doc-guide/ would be the place to look. Do you have specific questions? Thanks, jon
