I'd like to see a few more people become active comaintainers, some with commit privileges. I'd like to see specific people take responsibility for specific modules.
First, please be aware that it doesn't take commit privileges to help maintain this suite. It just means taking time in the issue queue, committing patches, developing new modules, and supporting people.
For committers, here are some proposed practices:
- Examples is a teaching project. The idea is to do the simplest possible thing that can explain a technique in the Drupal API (and make it easy for people to copy and paste to get started solving their own problem.)
- Keep it simple!
- Comment well.
- Don't show off fancy PHP or programming techniques unless they help people understand best practices.
- Try to use variable names and function names that make sense and disambiguate the usage.
- Every example module should have three basic means of access:
- Viewing and studying the code.
- Experiencing the code (enabling the module and following the menus). Note that every module should have at least one menu entry at examples/module_name that at the very least gives people a clue what to do next.
- api.drupal.org will be used to present and explain the code, and people use it directly, so make sure your doxygen is good.
- All work should be done in the issue queue. In other words, don't just commit stuff without showing the activity and explaining it in the issue queue. If you're going to fix something or improve it, do it in the issue queue. Wait until the tests come back green before committing. (If you think someone will help out and comment on the issue, wait for them as well. In many cases that won't happen. However, if several of us are comaintaining, maybe it will happen more often).
- All of this code ends up on api.drupal.org, so please make sure to use excellent and helpful doxygen comments.
- All work that involves new features or solves specific problems should have related tests, just like we do in core. Let's take every opportunity to improve the test suite.
- Use Drupal coding standards, and please run coder on your work.
- Please read the project page to get a clear idea of the philosophy proposed there
Comments
Comment #1
ilo commentedHi Randy, count with me with some of the modules (including D6 or D7 branches if you want, feel free to assign them if you have the feeling I have enough background on the modules also, otherwise I'll reply with a list of submodules I'd like to comaintain.
Thanks for all the job on this!!
Comment #2
mile23Hi. I'd love to help co-maintain. Best way to learn. :-)
Comment #3
tr commentedI'm willing to maintain the D8 version of Examples and keep it up-to-date with any code changes in D7 Examples as well as any code changes in D8 core.
Comment #4
rfayThat sounds like a big job. VCS access granted (as well as project page access and such.)
THANKS and WELCOME!
Comment #5
jn2 commented@rfay
Thanks for inviting me to be a co-maintainer over at #1050632: Edits for NodeAPI Example. I'd definitely like to be involved.
Is there a list of who takes care of which modules?
Comment #6
mile23Comment #7
jmolivas commentedI am interested in get involved as co-maintain mostly on the drupal 8 migration
Comment #8
smustgrave commentedhelping the maintainers of the example module clean out their queue some. This hasn't received a follow up or anything in 10 years so think it's good
Though may be relevant for D10 :)