Welcome, Meri


#1

I’m pleased to announce the Meri Alderdice has joined the project
as our Documentation Goddess. She’s technical, but not a coder.
(Actually, she does this documentation stuff for a living :wink: Over
the coming weeks and months, she’ll be putting together relase quality
documentation for the 2.0 release. We’re really lucky to have her and
I’d like to everything I can to help her put together quality docs
for us. There are a few things that we can all do to help meri help us:

  • When you build some new functionality, send rt-docs@fsck.com mail describing what
    you built and how it works (Not how the code works, but how the feature works)

  • If you see something that confuses you, work throguh the issue, then
    send mail to rt-docs@fsck.com describing the issue and its resolution.

  • If meri or one of her minions asks you how something works, do your best to
    get her as complete an answer as you can. The better your answer to her,
    the less likely you are to ever have to answer that question again. :slight_smile:

    Thanks,

    Jesse

jesse reed vincent – jrvincent@wesleyan.edujesse@fsck.com
pgp keyprint: 50 41 9C 03 D0 BC BC C8 2C B9 77 26 6F E1 EB 91
. . . when not in doubt, get in doubt. – Old Discordian Proveb


#2

(Not how the code works, but how the feature works)

Maybe the above line should answer my question, but anyway it’s not
completely clear: Will she write documentation for users, for developers
or for both?

(Btw, I’ve never seen the name Meri before, but Mari, Maria and Marie is
quite common names here in Norway :slight_smile:

Tobias Brox (alias TobiX) - +4722925871 - urgent emails to
sms@tobiasb.funcom.com. Check our upcoming MMORPG at
http://www.anarchy-online.com/ (Qt) and play multiplayer Spades,
Backgammon, Poker etc for free at http://www.funcom.com/ (Java)


#3

(Not how the code works, but how the feature works)

Maybe the above line should answer my question, but anyway it’s not
completely clear: Will she write documentation for users, for developers
or for both?

My primary audience for documenting things is the end-users. However, I will
be more than happy to document things for developers, but the core RT
developers who are tired of explaining how to develop for RT will have to put
up with me sitting on them to make them explain things to me before I start
writing things down. =)

(Btw, I’ve never seen the name Meri before, but Mari, Maria and Marie is
quite common names here in Norway :slight_smile:

It’s a long story. My real name Mary, but almost nobody calls me that. I
answer to both. =)