How to do Samba: Nicely: Difference between revisions

From SambaWiki
Line 25: Line 25:
===Proposing patches===
===Proposing patches===


Patches should be proposed as patches attached ''text/plain'' patches to the [https://lists.samba.org/mailman/listinfo/samba-technical samba-technical] mailing list. There are more details [[Contribute|on to Contribute to Samba]] at a technical level.
Patches should be proposed as git-am patches sent as attachments with the mime type of ''text/plain'' to the [https://lists.samba.org/mailman/listinfo/samba-technical samba-technical] mailing list. The more associated explanation of what the patch does or is intended to fix the better. If it's designed to fix a specific bug, please add a reference to the [https://bugzilla.samba.org Samba bugzilla] URL containing the bug in the form BUG: ''https://url''. There are more details [[Contribute|on to Contribute to Samba]] at a technical level.


===Seeking Feedback===
===Seeking Feedback===

Revision as of 23:38, 18 September 2018

DRAFT !!!: How to be a Samba developer and community member: Nicely

Samba strives to be a welcoming community, for users, developers and all who seek to use or improve Samba.

Samba is a Free Software project, and the quality of Samba is in both community we build just as much as the software we produce.

To aid this goal, the following are some hints of how we do community, collaboration and development togeather.

Communication

Mailing lists

The Samba project is mailing list oriented. Make sure you are subscribed to either or both of the samba-technical and samba mailing lists, and be active on those lists, remembering to help fellow users and developers as much as you ask for assistance.

Remember that these mailing lists are archived, so please be professional.

Your posts will be read by current and future employers, across multiple cultures. If an email wouldn't be considered appropriate in your work or college setting, it isn't appropriate on the Samba mail lists either, so please take care before pressing 'send'.

Collaboration and Contribution

Testing

When proposing changes to Samba, first check the changes are tested, and will pass our full testsuite via GitLab CI, or clearly mention that the change is still a work in progress with a subject tag like WIP:

Proposing patches

Patches should be proposed as git-am patches sent as attachments with the mime type of text/plain to the samba-technical mailing list. The more associated explanation of what the patch does or is intended to fix the better. If it's designed to fix a specific bug, please add a reference to the Samba bugzilla URL containing the bug in the form BUG: https://url. There are more details on to Contribute to Samba at a technical level.

Seeking Feedback

Actively seek feedback for your changes, ideally when still a work in progress. Others may have considered this area of Samba previously, or have an interest, their input can make your changes better.

Giving Feedback

Be practical with feedback. If possible, feedback should be concrete, a revised patch is even better (as it leaves less room for confusion).

Give your feedback early if possible. The earlier the feedback is given the easier it is to incorporate your thoughts. Likewise, if changes have already been proposed a number of times, please help finish the patches off rather than suggest a total re-work.

Always play the ball, not the player. All of us are invested deeply in the work we do, so be respectful of the effort put in to make the changes. A few words of thanks and appriciation go a long way, especially when a concern needs to be raised.

Finally, do avoid the every-tempting risk of bikeshedding.

Accepting Feedback

Be honoured that a fellow member of the community has taken the time to look at your changes, and be humble when accepting the feedback. Try not to take feedback on the changes personally, but do seek to improve both personally and professionally in response to concerns or suggestions.

Take the time to work though the feedback given. While it will sometimes seem to be out of all proportion to the change involved, respect those giving their time to comment on your work.

Requesting a change be reverted or withdrawn

If possible, we prefer not to revert changes that have already gone into master, and to avoid withdrawing patches already proposed. If there is a practical technical reason such a change should not be accepted or reviewed, please make this case on the appropriate list. If it's a case of an "oops, mistake" in the patch we'll be happy to pretend it never got posted.