Hi Hive developers,

I'd like to discuss my idea, which provides a single source for Hive
contributors.

Recently, I reviewed multiple pull requests submitted by new
contributors. Our Query Unit Test suite was tricky enough for new
people, and we sometimes needed to guide them through GitHub or
e-mails. It requires some contexts like the directory structure or
various types of TestCliDriver. I think a comprehensive document would
be helpful.

We already have three documents that describe how to use the testing
framework. It is hard to remember which contains the latest
information as they all have generic titles. Also, I think some
content is not aligned with real needs(e.g., branch-1 or branch-2 are
unimportant for most people in 2024). I guess they can be barriers for
new developers.
- Developer Guide:
https://cwiki.apache.org/confluence/display/Hive/DeveloperGuide
- How to Contribute to Apache Hive:
https://cwiki.apache.org/confluence/display/Hive/HowToContribute
- Hive Developer FAQ:
https://cwiki.apache.org/confluence/display/Hive/HiveDeveloperFAQ

Then, I'd like to propose creating a document for developers tuned for
2024 and deprecating the old documents. This will help new
contributors develop Hive, and existing committers support patch
authors. Do you know if this initiative is viable?

If it is viable, where should it be written, i.e., WIKI or hive-site?
I guess we prefer hive-site for new pages, but that might not be true.

Regards,
Okumin

Reply via email to