- ([personal profile] rho) wrote in [site community profile] dw_docs2009-04-10 06:42 pm

Bringing in more people

This entry isn't really going to be saying anything concrete. It's mainly just me putting some of my thoughts onto pixels. I'd very much appreciate any thoughts that any of you have on this, though.

At various points, from when I first took over the documentation project to this morning, I've had various people expressing an interest at getting involved with FAQs/copy/proof-reading/whatever and I've had to turn them down, for one reason or another. It breaks my heart a little bit every time I've had to do that, because I really firmly believe that everyone has something useful to offer and everyone should be able to concentrate.

The problem, for now, is that expediency is trumping pretty much all other concerns. We have a bunch of things that we need to get written by Open Beta, and getting them written is my priority. Paradoxically, asking more people to contribute at this point would be counter-productive to this goal. Time spent training people up to write in our style and to use our tools would take away from the time we have to actually write things.

In choosing my teams, one thing I was looking out for was people who I thought would be able to get writing with minimal training: people who were self0sufficient in learning new skills, for instance, or people whose natural writing styles mostly closed matched the Dreamwidth style.

Fortunately, writing documentation is a lot like writing a book. It's impossible to ever finish. There'll always be some wording that could be made clearer, some feature that isn't documented properly, or some new way of presenting things. No matter how good our documentation is, we'll always be able to make it better.

As we move on after the Open Beta launch, I want to try to bring as many people as possible into the process. The development team are doing a wonderful job of getting new people involved and training them up ([site community profile] dw_dev_training for instance) and I want to use what they're doing as a model for what we can do over here.

One of the problems will be that we don't have the same tools as the devs do. We don't have any nice mechanism for people to submit patches to update site copy or FAQs. We have just two options: either we can say "hey, I think that this should say this instead" or we can put it actually live on the site. This is less than ideal.

In the long-term, we're going to be scrapping the existing FAQ system and translation system and replacing them with new, better systems of our own devising. One thing that I'm keen on working into the new system from the start is some decent form of version control. I want for us to be able to make changes and have them sitting in the back-end where we can look at them, and then to be able to put them onto the live site when we're happy with them.

For now though, that isn't an option, so we'll have to figure out some other way of doing things. One possibility is to let everyone who's interest make suggestions for additions and improvements, but instead of just saying "yes" or "no" for us to then work with you to let you know why we think it's a good or a bad idea, how you can improve your suggestion, and so on. That way, hopefully, we'd be able to have people improve, and eventually reach the point where they'd be the ones who are giving the advice and making the actual changes on site.

I'm not really sure what the best way to try to organise this will be, nor even if it's going to be a good idea to have any sort of formal organisation at all. I just know that the general idea of bringing more people into the fold is one I'm committed to.

So what do you think? If you're currently on the team, how would you feel about helping to train up new people? If you aren't currently on the team, what would be most useful to you and make you want to get involved?
zvi: self-portrait: short, fat, black dyke in bunny slippers (Default)

[personal profile] zvi 2009-04-10 06:31 pm (UTC)(link)
As an outside observer, it sounds like what y'all need for an intermediate staging area/training ground is a wiki
denny: Photo of my face in profile - looking to the right (Default)

[personal profile] denny 2009-04-10 06:40 pm (UTC)(link)
Word for word what I was going to comment.
montanaharper: close-up of helena montana on a map (Default)

[personal profile] montanaharper 2009-04-10 07:51 pm (UTC)(link)
My thoughts exactly. Though I might even have gone so far as to say that maybe the FAQ should just be a wiki, with only vetted people able to make changes.
adalger: Earthrise as seen from the moon, captured on camera by the crew of Apollo 16 (Default)

[personal profile] adalger 2009-04-10 09:52 pm (UTC)(link)
This.

I was going to suggest a section of the dev wiki could be devoted to site copy with zero additional effort. Just create a FAQ_draft category, and voila.
ephemera: celtic knotwork style sitting fox (Default)

[personal profile] ephemera 2009-04-10 07:50 pm (UTC)(link)
hmm - could be because I'm not super-familiar with wikis as spaces for team interaction, but I'm not quite seeing why it's obviously *IT*. I can see how the wiki could be used as a repository of policy guides / final rulings on terminology / 'how to' guides, and that kind of thing, (maybe also as a 'holding cell' for copy to be reviewed before it's set live, although in terms of being able to easily see/contribute to/discuss the evolution of the text I'd default to a DW com rather than a wiki), but I'm not seeing it as a *training* solution - surely something more conversation-focussed - a chatty DW group, semi-official mentors on hand to review copy, that kind of thing? Or am I totally missing the point?
montanaharper: close-up of helena montana on a map (Default)

[personal profile] montanaharper 2009-04-10 08:00 pm (UTC)(link)
As an example, take a look at this page, at both the Article tab and the Discussion tab. (I would've linked to one of the DW wiki pages, but a quick scan didn't turn up any that had discussion on them, so I turned to something I knew. *g*)
ephemera: celtic knotwork style sitting fox (Default)

[personal profile] ephemera 2009-04-10 09:14 pm (UTC)(link)
ohh - interesting. I've not seen that sort of discussion in any of the wiki's I've had reason to use.

(My experience has been that either the discussion all goes to email / IM / in person with the wiki edit being the 'final destination' and/or people engaging in endless rounds of 'I disagree so I just change it' 'but I was right! I just change it back!' with increasing levels of irritation, when some conversation about the *why* would have made the whole thing less painful and more useful.)
rian_aphasia: Lyn-Z; Mindless Self Indulgence (backbend by burnburnx)

[personal profile] rian_aphasia 2009-04-21 03:21 am (UTC)(link)
(My experience has been that either the discussion all goes to email / IM / in person with the wiki edit being the 'final destination' and/or people engaging in endless rounds of 'I disagree so I just change it' 'but I was right! I just change it back!' with increasing levels of irritation, when some conversation about the *why* would have made the whole thing less painful and more useful.)

This has been my experience too. What I've seen that seems to work well is having one central area, like an entry in a comm, where the original draft of whatever the group is editing resides (ex. a FAQ page). It's only accessible to one or two people charged with actually changing the text around as consensus is reached.

Then there's a discussion thread where people can come in and say "From X to Z needs to be changed because the explanation is too complicated; let's try something like ::blatherblatherblather::", "This section doesn't provide clear explanation for people with vision issues; here's what we can do to fix that...", or "We need to find and replace all gendered pronouns to they/themselves or zie/hir/hirself", etc. And people can reply to each other and engage in discussion with each individual issue at hand.
stultiloquentia: Campbells condensed primordial soup (Default)

[personal profile] stultiloquentia 2009-04-11 12:48 am (UTC)(link)
Is this as good a place as any to say, "Add me to your volunteer list"? I can't code anything more complicated than CSS/XHTML, but I'm pretty good at words -- writing, proofing, whatever. I'm all yours, and easy to train. Just point me in the right direction and say, "Assimilate!"

Also: wiki. Yep.
hatman: HatMan, my alter ego and face on the 'net (Default)

[personal profile] hatman 2009-04-11 05:32 am (UTC)(link)
Yeah, I'm not much for Wikipedia, but the Wiki format seems to me to be well-suited to the task at hand.

In any case, thanks for the explanation. Makes sense, and makes me feel a bit better. :)

(And as for you, Internal Editor... Yes, this is a post about editing, but you don't have to jump up and down over every typo or misplaced hyphen.)
sine_nomine: (Default)

[personal profile] sine_nomine 2009-04-11 01:29 pm (UTC)(link)
Rho, thanks for all your hard work!!

I have zero interest in writing but I'm a proofreader and would love to help out in that arena, if such skills are needed.
ladyvox: (Default)

[personal profile] ladyvox 2009-04-12 11:07 am (UTC)(link)
When you mention the "translation system" are you then talking bout how the site code translates in whatever it shows on the site, or are you talking about the actual language translation system that lj has in place currently for getting language specific pages (or however you guys are going to set up such a system). I have done my fair share of translating english-dutch on LJ and if you guys are planning on offering DW into multiple languages as well I'd be very willing to help out there.

I would love helping out with a project/things that I totally dig. :) I am an avid gamer and can't help but throw myself up for some extra tasks for the guild(s) I am in as well, be it setting up and admining a forum online or just by keeping track of whatnot in game or adding/editing info on the eq2 wikia for instance. /smiles I guess I just like to be a bit more actively involved in stuff that I enjoy on a daily basis, then to just be a user/member. I do think I have what it takes to work in a team and while I am not a programmer/developper I do know how to work with codes and sorts. I think I do anyway ;-)

As for what would be handy to have as reference for new team members.. I'd have to think some more about that.

[personal profile] chasy 2009-04-12 12:25 pm (UTC)(link)
I'm okay with helping people proof - I've not done any site copy and possibly, in the beginning, I'd need someone to help ME but if site copy needs more trawlers, I'm willing to step up to the plate...but I'm also all for showing someone how to proof. :)
denelian: (Default)

[personal profile] denelian 2009-04-14 05:42 am (UTC)(link)
i think i am seeing something, but maybe this is covered by the Wiki resolve; to whit, how do you get various people to do different tasks, not overlap on some and totally ignore others?

i have a (stolen) novel solution. if you have ever read Irregular Webcomics, the webcomicartist used to do, and now does a different, "volunteer webcomic"
he basicly pooled the volunteers (by type - writer, artist, colorer, letter-er, etc) and set up a rotation - there were like 200 writers (that was the only group i was in) and there was, IIRC, a single webcomic scheduled a week... so he generated the list (by timestamp on the email, but however) and just had the rotation go through: comicwriter1 wrote the first open script, comicwriter2 wrote the second, etc.

it sounds really simplistic, and i only suggest it because i am guessing you will have *lots* of volunteers, and a lot of times simple solutions are perceived as being *too* simple. if you are as inundated as i expect, you'll totally need to both ride herd on us and pass things out easily. i am sure there are multiple ways to make this sort of system work specifically for you guys - i'm just trying to give you a basic look.
and hey, if there is a *better* way, it would be useful to learn that, too lol.

all that said, i'm a decent proofwriter and am a Communications(Journalism)/Political Science major (senior year). use away :)

(as a sorta personal question; do you think after you guys are more up-and-running you would be willing to try an internship sort of thing? i ask because i am disabled, hip displaysia, surgery didn't work - i have issues sitting up for more than about an hour, and all the internships i can find require 6-8 hour workdays *in* the office, no working-at-home sort of things, and i cannot do that sort of work setting. i am not really asking, asking, right now; i am throwing out an idea, expecting you [the entire team] to not even really think about for months, just let it bubble in your collective subconscious 8-) )
Edited 2009-04-14 05:44 (UTC)
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

[staff profile] denise 2009-04-14 05:46 pm (UTC)(link)
Most of what you're suggesting is the kind of stuff that will go in [site community profile] dw_volunteers as we start to use it -- project teams, etc, will post openings for things that need to get done, and people can step up and offer help.

As for internships, we aren't going to be able to afford paid staff for quite some time -- see Mark's answer to the dw_biz Q&A -- so we are going to be highly dependent on people volunteering. Both Mark and I come from the LiveJournal volunteer culture, where the expectation was always that you would do what you could, when you could, as you had the time and energy to do it. There's actually a very high percentage of people with disabilities already volunteering with Dreamwidth in some way or another, because a lot of people who are living with disabilities in some way or another are often out of the workforce and looking for something to channel their energy and passion into! (I'm disabled myself, so I know how important it is to have something that you can work on, in your own time, at your own energy level.)

So yeah, long story short: there will be many many opportunities for volunteerism, and we're very aware of the needs of people with disabilities and are very very committed to making volunteering possible/easy, no matter what your individual accessibility needs are. (And we're glad you're interested!)
denelian: (Default)

[personal profile] denelian 2009-04-14 09:06 pm (UTC)(link)
yeah, most internships aren't paid (but they expect you to live somewhere else and afford the housing but not get another job... sigh)
thats why i asked, because its online and in one of your posts you mentioned that you were disabled and how this particular venue is good for accomidating it (i can't spell today; i can't even wake all the way up.)
but internships are generally unpaid; i was asking, essentially, if at a later point i became a constant/consistant sort of volunteer and everyone is happy, can you (or whomever) sigh the paperwork to allow me to get school credit for interning. (that being the difference between volunteer and intern :) i was not asking for a paid job of any sort... while i am excited about DW, when i grow up (whenever i get around to it, i mean i'm already 32 and not grown up lol) i plan on working for the State dept, hopefully in an embassy. which i could not do if i were working for someone else :D

i will go ahead and put the volunteers on watch, or whatever the word here is :) (it will let me watch, but when i click the link to join, i get a 404 message. i don't know if this is you or me...)
denise: Image: Me, facing away from camera, on top of the Castel Sant'Angelo in Rome (Default)

[staff profile] denise 2009-04-15 01:11 pm (UTC)(link)
Oh yeah, we will happily fill out whatever paperwork's necessary to make sure that our volunteers get course credit if their school offers it, as long as they're already volunteering with us -- I've already filled out one set of paperwork for someone. :)
denelian: (Default)

[personal profile] denelian 2009-04-15 07:45 pm (UTC)(link)
am i allowed to say "w00t"?

now i just have to convince the SCHOOL, when it comes time :)

[identity profile] nightengale.livejournal.com 2009-04-19 03:17 am (UTC)(link)
Heya! I'm coming to this project a LOT late. But I want to be part of the team! Copywriting, copyproofing, documentation-writing - anything involving the creation of words and sentences and paragraphs and so on, I can do and do well. I'm a Masters student in English and Creative Writing right now, and I can match any writing tone. I can't tell from this post and the other post that's tagged "volunteers" in this comm whether you are NOW accepting more people onto the team, or whether you WILL be when the site launches into Open Beta on the 30th, but it doesn't matter much to me anyway: I will be done with my academic semester on the same day that Dreamwidth launches for membership, and I would *LOVE* to get my hands dirty helping out at the same time that I'm getting my yet-to-be created DW user account up and running. I'm a fast writer; I have tight syntax, adaptable diction, and (almost) perfect punctuation, and I take critique very readily and eagerly.

Also I like kittens. ♥

Contact me here or at red nigh ten gale at gm a il dot co m!
hekaterine: (Default)

[personal profile] hekaterine 2009-04-20 07:51 pm (UTC)(link)
I'd like to help, but I'm just another user with no experience.
Maybe in the future.
You're doing a great work. Just wanted to say that.
rian_aphasia: Lyn-Z; Mindless Self Indulgence (backbend by burnburnx)

[personal profile] rian_aphasia 2009-04-21 03:34 am (UTC)(link)
If there's a list anywhere with names for when you need more volunteers for copy editing, I'd like to be on it. I'm a reader, so stuff like bad explanations "ping" for me, and I have good spelling and grammar in non-casual writing (I almost went to school for English Language and Lit). I notice directions and explanations that are ableist and plain don't help for people who use sites like this differently than a lot of us, and I actually rewrote directions and usage guidelines when I worked in the Feminist Studies Library at UC Santa Cruz. I was thrown into a supervisory role, with very little training, within a month of starting at the library, so I'm used to having to find answers on my own. While I enjoy and find a group-dynamic helpful, I don't rely on it to do my part well.
earenwe: (groogrux king : dave matthews)

[personal profile] earenwe 2009-05-01 05:18 pm (UTC)(link)
To be honest, I just like to help. And I like the idea of a wiki to use as a place for ideas to form and grow before actually going elsewhere to take their semi-permanent place. While wiki is nice, I'm not sure that it would fit the layout that I've seen (nice and clean) so far of the site.

A training team, I think, would be preferable, so that everyone is on the same page as far as what things are permissible and what are not, etc.