[pgpool-hackers: 3393] Re: [PATCH] Doc: Fix wrong conjugations and connectors in what-is-pgpool

[Tatsuo Ishii]

Hi Alejandro,

> Hello mailing list,
> 
> While reading the docs, I found some typos in the what-is-pgpool page 
> that made it harder for me to understand the meaning of the sentences.
> I hope this patch can improve the legibility of that paragraph.

Thanks for the patch. The patch looks good to me and am going to apply
it.

> On the other side, I wanted to mention that it was also difficult for me
> to know how to contribute to this project, at least for sending this
> patch for the docs.  I wasn't sure if a doc fix should be sent as a bug
> to the bug tracking tool in [1].  Also, I didn't found a CONTRIBUTING
> file in the source code neither.  A resource that did help me was this
> email thread [2] sent some years ago.  The user was also looking for a
> document that describes the workflow for submitting patches.  At the
> end, I followed the PostgreSQL project guidelines.

Yes, we follow the PostgreSQL project guidelines, except we don't have
pgsql-docs or pgsql-bugs mailing list. The reason we don't have
pgpool-docs is, we don't have enough traffic for the topics. The
reason for absence of pgpool-bugs is, we have mantis bug tracking
system instead of course.

> Does such document or web resource exist? If not, what would you say if
> I send an initial draft for it. I think it would make it easy for new
> contributors to start working in the project. Even if it doesn't state new
> guidelines, the document could at least state that this project follows
> the PostgreSQL project guidelines and indicate the user where he can
> find more information about them.

That kind of document does not exist for now, but I agree, such
document should exist. I will appreciate if you send an initial draft
for it.

Best regards,
--
Tatsuo Ishii
SRA OSS, Inc. Japan
English: http://www.sraoss.co.jp/index_en.php
Japanese:http://www.sraoss.co.jp