[med-svn] [Debian Wiki] Update of "DebianMed/MoM" by LaszloKajan

Tue Jun 19 11:06:28 UTC 2012

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Debian Wiki" for change notification.

The "DebianMed/MoM" page has been changed by LaszloKajan:
http://wiki.debian.org/DebianMed/MoM?action=diff&rev1=22&rev2=23

Comment:
spelling corrections and gender equalization: use 'she' as well as 'he'

  = Mentoring of the Month (MoM) =

- In this effort the mentor dedicates a part of his spare time to a newcomer (the "student") providing any packaging knowledge the Mentor has to
+ In this effort the mentor dedicates a part of his spare time to a newcomer (the "student"), providing any packaging knowledge the Mentor has to
- enable the student working more or less independently on packaging after passing this MoM period.  The mentor will guide the student kindly into all secrets of Debian packaging at the example of a specific program which is in the focus of the Debian Med team.  The student is free to pick the package however, the mentor has a vetoing right in case he sees the package in some way as "unfit for the MoM project" (too complicated, too non-free, too far away from Debian Med topic, too whatever).  At the end of the month the goal is that
+ enable the student to work more or less independently on packaging after passing this MoM period.  The mentor will guide the student kindly into all secrets of Debian packaging with the example of a specific program, which is in the focus of the Debian Med team.  The student is free to pick the package, however the mentor has a vetoing right in case he sees the package in some way "unfit for the MoM project" (too complicated, too non-free, too far away from Debian Med topic, too whatever).  At the end of the month the goal is that

-  a. The package in question is finished and uploaded
+  a. The package in question is finished and uploaded.
-  a. The student is able to do advanced packaging tasks and is introduced into the communication channels of Debian Med team
+  a. The student is able to do advanced packaging tasks and is introduced into the communication channels of Debian Med team.

- The communication about this should be tagged with "[MoM]" in the subject line of the exchanged mails to enable others who might not be interested to procmail it out of their focus and enables other potential students to learn from this.
+ The communication about this should be tagged with "[MoM]" in the subject line of the exchanged mails to enable others who might not be interested to procmail it out of their focus, and to enable other potential students to learn from this.

  In this MoM process I would like to apply some strict rules:

-   1. If the mentor is posting something on the [[http://lists.debian.org/debian-med|mailing list]] containing [MoM] in the subject the student tries hard to respond with any comment (if not better possible something like:  I have no idea but I will do some research like asking upstream or whatever - just leaving a hint that he feels responsible somehow).
+   1. If the mentor is posting something on the [[http://lists.debian.org/debian-med|mailing list]] containing [MoM] in the subject, the student tries hard to respond with a comment (if not better possible, something like:  I have no idea but I will do some research like asking upstream or whatever - just leaving a hint that he feels responsible somehow).
-   1. The student tries to follow any of the commits of the mentor to the package which is in focus of the MoM plan and favorably sends a comment like
+   1. The student tries to follow any of the commits of the mentor to the package which is in focus of the MoM plan, and favorably sends a comment like
        * Its OK for me
        * What does this mean, please explain
        * I would prefer ... instead of your change
-   To get informed about the changes the student needs to be subscribed to the [[https://lists.alioth.debian.org/mailman/listinfo/debian-med-commit|commit mailing list]] or checks regularly the logs in the repository (''svn up | git pull; {svn|git} log''). He just tries to find a useful comment to any commit just to make sure he has understood things and will be able to do it himself in the future.
+   To get informed about the changes the student needs to be subscribed to the [[https://lists.alioth.debian.org/mailman/listinfo/debian-med-commit|commit mailing list]] or check the logs in the repository regularly (''svn up | git pull; {svn|git} log''). He or she should try to find a useful comment to any commit to make sure he has understood things and will be able to do it himself in the future.
-   1. The student confirms that he succeeded in building the package according to the state in Vcs in case it builds or he is able to reproduce the error message of the build process.
+   1. The student confirms that he succeeded in building the package according to the state in Vcs in case it builds, or that he is able to reproduce the error message of the build process.
-   1. If there is any problem the student will ask on the [[http://lists.debian.org/debian-med|Debian Med mailing list]] (tagging the subject [MoM] to not spam others to much.) This list should be the main communication channel to show others:
+   1. If there is a problem the student will ask on the [[http://lists.debian.org/debian-med|Debian Med mailing list]] (tagging the subject [MoM] not to spam others too much.) This list should be the main communication channel to show others:
        a. we are working on a problem
        a. how things could be sorted out via open discussion
        a. how they could learn things about packaging
-   Communicate can also be done via ''#debian-med'' IRC channel
+   Communication can also be done via the ''#debian-med'' IRC channel.
-   1. The student post a status report about the packaging every day reporting about changes he did, issues he faced or discussions he did with upstream etc.
+   1. The student posts a status report about the packaging every day, reporting about changes she did, issues she faced or discussions she did with upstream etc.

- Please be careful.  The MoM plan is ''work''.  While it is intended to show that work can be fun the mentor expects the student to do some work in the same way as the mentor is offering a part of his spare time to do the other part of the work which needs to be done.  So the mentor will ask the student whether he did his part of the work.  If not the mentor will stop the work on this package and will continue with another MoM student and his
+ Please be careful.  The MoM plan is ''work''.  While it is intended to show that work can be fun, the mentor expects the student to do some work in the same way as the mentor is offering a part of his spare time to do the other part of the work which needs to be done.  So the mentor will ask the student whether he did his part of the work.  If not the mentor will stop the work on this package and will continue with another MoM student and her
  package (in case there might be a waiting list).

  The MoM effort was created in the hope that we will be able to train those silent observers of the list to become more vocal.  This training not only provides technical knowledge.  It turned out that this is only 50% of the job.  The other part is communication which is heavily underestimated.  By communication we do not mean plain chatting.  It is about communication that leads straight to a technical implementation.