[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
RE: [stp-dev] Suggestion for extra pages in STP wiki
|
I agree with you Alex. Wikis are an effective medium of
communication and collaboration and they do make it easier to contribute docs to
a project.
But I don't think we should ship version 1.0 of the STP
next year without a comprehensive help plugin. I see the Wikis as source
documentation for the final output, which should be online help, delivered with
the STP and available as an infocenter.
From: stp-dev-bounces@xxxxxxxxxxx
[mailto:stp-dev-bounces@xxxxxxxxxxx] On Behalf Of Alex
Boisvert
Sent: 27 November 2006 20:45
To: STP Dev
list
Subject: Re: [stp-dev] Suggestion for extra pages in STP
wiki
I also believe wikis are an effective medium of communication and
collaboration. In contrast with David's opinion, I find wikis to be
more up-to-date because they make it easy to update the content. I
do think the structure aspect is a challenge but that's true of any
documentation effort. But more importantly, I have noticed wikis
lower the barrier to documentation contributions which is very important for
open-source projects. Programmers tend to want to spend as little time as
possible on documentation and my observation is that wikis make that precious
little time more impactful...
regards,
alex