So if you've ever thought about submitting a patch but were a little intimidated, go ahead! It's really not that bad
Thanks for this encouragement
I would like to raise some issues I learned during posting hundreds of patches in the past and accepting them now after having write access.
1. Doing patches is easy. For documentation even easier.
'metalogic' already refered tutorial at wxWidgets. Note that doing documentation patches (the most frequent observation from community is related to minor differences between reality and manuals) is even easier, just try: http://wiki.wxwidgets.org/docpatcher/
2. Don't affraid to post patches because you are newbie.
Newbies are more sensitive to the issues which experienced users ignore due to their knowledge what's good and what's bad. Experienced user never visit
install.txt and/or never experiment with unusual build setting. They never assume limits on input parameters and use strange values. wxWidgets should work out of the box. wxWidgets is not only for experienced users. If you think you know how to improve your newbie introduction give it to the community.
3. Don't affraid to post patches because you are experienced from other community that your contribution will be ignored.
Persons with write access are not AI machines. They have real life, real needs, real amount of free time. But that doesn't mean they ignore you. Notification about bugs and patches are automatically forwarded to wx-dev mailing list so there is a great chance that it will be spotted by one of core developers immediatelly. But even if it will be not noticed your issue stays within tracker and is listed in every visit in tracker page. Moreover on statistic page of wxWidgets account at sourceforge.net there is always number of opened issues which mobilizes us to frequently study remaining issues (where 'frequently' is relative
to other development, phase of roadmap between releases and real life)
4. Don't affraid to post patches because your problem was already raised in wxForum or wx-users mailing list.
Doing commits and development is one thing and posting in wx-users and wxForum is second thing. Just because somebody raised issue in available forums it doesn't mean that we are reading it at the same time we develop. This is simple: wxWidgets developers are just humans. We want to help users as much as we can but between and within long discussions and explanations some small posts without question asked can be easily missed. Even quite important issues can be lost just because developer went into other real life problem after visiting forum. Do not return to this forum after a week saying somebody ignored you. Just allow us to track your contribution and if waiting happens just redirect your issue to tracker.
5. Don't affraid to post patches because your previous patch is still open.
Never assume anything about wxWidgets developers opinion and willings about your patch without any comment given. Testing patches is time consuming, involves testing of more than one platform and as such requires some setup and adequate amount of free time. Sometimes it raises discussion between developers which is invisible to you. Note you can make such waiting shorter yourself. Just try to find somebody who will test your patch before developers and will add feddback to patch tracker. The more opinions added to tracker, the greater chance it will be safer to commit your contribution. Also if there is any discussion predating patch, just add a reference to it if it gives better background about patch details.
6. Don't affraid critics of patch quality.
wxWidgets is complex. wxWidgets is multiplatform. Patches have to silently improve all ports and features which share part of code touched in patch. Moreover they have to be consistent with wxWidgets codings standards which sometimes differ from habits of patch poster. Do not immediatelly take offence when it is pointed out to you. Just help us by giving improved patch once we have time constraints and asked you about corrections.
7. Don't affraid rejected patches. Do not think your time was wasted.
We know you had good intentions doing your patch. We know you made it in your free time. But consider that development is going forward and we fixed already many things in Head of CVS. But think about your finding as lesson about wxWidgets internals which you had to read and understand to solve problem. And what about new features? wxWidgets is not unlimited box. Consider posting new features into wxCode and other nice places.
Thanks in advance for new contributions!
(perhaps it belongs to other group of this forum, it's not Open Discussion)