| 1 |
On Sat, 3 Oct 2009 20:45:21 +0300 |
| 2 |
Markos Chandras <hwoarang@g.o> wrote: |
| 3 |
|
| 4 |
> This is actually true. Maybe all devs should have access on docs since the |
| 5 |
> docs teams are dead. I would suggest to let all developers contribute to |
| 6 |
> documentation whether they belong to docs team or not |
| 7 |
|
| 8 |
No. Many (most?) devs do not write good documentation. Their native language may not be English. They don't know the coding style. They don't know how to write code that validates. They're not good at putting together step-by-step instructions with helpful, explanatory text. They don't know all the myriad documents that need editing to pick up the change made to one part of a different document. |
| 9 |
|
| 10 |
The GDP team is not dead, fer cryin' out loud. I just replied to Allen's message elsewhere in this same thread. |
| 11 |
|
| 12 |
As I said in that thread, you can't force people to write documentation, patches, or even a plain-text list of "change foo to bar" alterations. |
| 13 |
|
| 14 |
We still can't force developers to use repoman when they commit, or force developers to not break dependencies EVERY TIME they commit even with repoman. We can't force developers to contribute EVERY TIME they make a change to a package, or pick up upstream's changes. It'd be nice if we had a really integrated system for doing packages and docs at the same time, but it's not possible to make people do what you want them to do. |
Archives