[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: tarsnap website redesign
On Tue, Aug 11, 2009 at 10:45:08AM +0200, Mads Sülau Jørgensen wrote:
> On 11/08/2009, at 01.27, Graham Percival wrote:
>
>>> *Twitch*. I need to get over my irrational dislike of wikis.
>>
>> No you don't. As a documentation guy, I have an entirely
>> *rational* dislike of wikis. Trust me on this. Give in to your
>> hate. Join the Dark Side. :)
>
> If you have a rational disliking of wiki's, please do share your reasons
> for such a disliking, especially whatever reasons are relevant for the
> project at hand - without using the force :)
>
> I think you might be looking at this from the eyes of a project
> maintainer and me as a user.
As a project maintainer, a wiki encourages the attitude that
"somebody else will do it", from both developers and users. One
of the best motivations for people to work on docs is a feeling of
ownership. Telling X that he's responsible for section 2.3
results in much more work than just saying "hey guys, let's work
on sections 1.1 to 2.8!".
As a user, quite apart from the out-of-date-ness of most wikis,
they generally result in a collection of individual pages, rather
than maintaining a consistent documentation style and voice. The
overall organization is generally lacking.
For the record, I've never set up a wiki; I'm speaking purely as a
doc writer/editor and reader.
Granted, none of these issues are pressing in this case, since
we're talking about a single page rather than a set of pages.
Still, wikis are generally worse than useless for small projects.
Too many people use them as a replacement for documentation. In
some cases, they might be suitable as an addition to docs, but
even then, I'm not convinced that they actually save time for the
developers / official doc writers.
>> Why don't you encourage users to send scripts to -users or you
>> personally?
>
> I really don't care where or how such content would be contributed, but
> if I am to contribute to it, the time I need to spend on doing just that
> should be minimal.
Sending an email is much more minimal than editing a wiki. I
mean, you can use your favorite text editor for emails, whereas
wikis have the pathetic web browser "text edit" box. :)
Cheers,
- Graham