post: wiki.d.o/Teams redux
[homepage.git] / blog / posts / 2010 / 05 / document_your_team_-_redux.mdwn
1 # [wiki.d.o/Teams](http://wiki.debian.org/Teams) to the rescue
2
3 [About 3 years ago](http://lists.debian.org/debian-devel-announce/2007/05/msg00008.html)
4 <small>(too bad I've actually missed the 3-year anniversary by a few
5 days!)</small>, [Raphael](http://www.ouaza.com/wp) set up
6 <http://wiki.debian.org/Teams>.
7
8 In my recent encounters and contacts with people interested in contributing to
9 Debian, I've found that page to be of invaluable help. In particular, people
10 find it very useful in **understanding the macro-structures of Debian** and in
11 understanding **where they can start** to contribute. Approaching a team is
12 most likely "less scary" than contacting a larger forum, and that page offers a
13 good service of team indexing.
14
15 Of course, the usefulness of `wiki.d.o/Teams` is directly proportional to how
16 much complete it is and to how much individual team pages are current. So, in
17 case you didn't know about the page or that you just remembered that years ago
18 you set up a page there and then forgot about it, this is probably a good
19 moment to **add or update your team information** there.
20
21 To eat my own dog food, I've recently set up
22 [Teams/DPL](http://wiki.debian.org/Teams/DPL), which is probably not terribly
23 useful, but it contains interesting stuff such as where the daily activity bits
24 are stored. <small>(Yes: I'm just a one-person-team, but given the index is
25 useful to document Debian "parts" in general, I believe we should allow for a
26 slightly semantic abuse of the name.)</small>
27
28 Incidentally, that shows another way in which wiki team pages can come to the
29 rescue: improve the **documentation of our processes**. For instance, we are
30 grown accustomed to the fact that
31 [`d-d-a`](http://lists.debian.org/debian-devel-announce) is an authoritative
32 information source. Well, of course it is, but when you need to find out a
33 4-year old `d-d-a` post of some core team, since it is the only documentation
34 of some still current (is it?) procedure, let's be fair and acknowledge that a
35 mailing list archive it's not *that handy*. So, **summarizing relevant `d-d-a`
36 posts in team pages** is another way, accessible to everybody, to help in
37 keeping docs current. I've been doing that recently for a handful of teams, and
38 people seem to appreciate <small>(of course it's your responsibility to check
39 that they *do* appreciate)</small>.
40
41 [[!tag lang/english planet-debian debian dpl]]