Greg Stark wrote:
> On Tue, Jul 21, 2009 at 5:51 AM, Robert Haas<robertmhaas@gmail.com> wrote:
>> I really, really think you need to find someone to help you with the
>> documentation. As I've said before, your English is a lot better than
>> my Japanese, but the current documentation is just hard to read.
>
>
> In general we're very generous with English writing quality. I
> wouldn't worry too much about the language barrier as far as writing
> documentation.
>
> However the snippets Robert posted of the documentation had a more
> fundamental problem unrelated to language. The problem is that it
> explained what an option did in terms of what that option did -- ie,
> the documentation only made sense if you already knew what it was
> trying to say. That's not an unusual trap to get into when writing
> documentation regardless of what language you're writing in.
>
Indeed, language quality is a causality, but not all.
The matter is we've not been able to share what does it try to
achieve correctly, what is identicals or differences between
database privileges and SELinux's security model, and so on.
Thanks,
--
OSS Platform Development Division, NEC
KaiGai Kohei <kaigai@ak.jp.nec.com>
