CZ:How to Collaborate: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Larry Sanger
No edit summary
 
(21 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Communication}}
''Citizendium'' is a collaborative community.  Your knowledge, with the next person's, and the next, build and shape, re-build and re-shape, the articles of this compendium.


Many people spend their wiki time working on pages that other people have startedIf the page creator is still hanging around, you'll have to collaborate with that person, and anyone else interested, in crafting the article further.
So, how ''do'' a bunch of strangers manage to create a coherent encyclopedia article?  Generally,  it's like this: you see that a sentence needs rewording; so you reword it.  You see an article that needs a whole new section; so you add it.  You find that an article has much flabby prose; so you make it conciseOr you just know a lot about a particular subject and see much to change; so you go through and make a thorough overhaul.  Many people can do all of those things to the same article, and something excellent can result.


So, how do a bunch of strangers manage to create a coherent encyclopedia article? It is one of life's mysteries, perhapsGenerally, though, it's like this: you see that a sentence needs rewording; so you reword it.  Or the article needs a whole new section about something; so you add itOr the article has much flabby prose; so you make it conciseOr you just know a lot about the subject and see much to change; so you go through and make a thorough overhaulMany people can do all of those things to the same article, and something excellent can result.
Working closely with others often requires sensitivity and finesse.  You might have deleted a sentence it took someone else five minutes (or five hours) to craft. Resentment and anger are often the immediate responses when someone else changes "your" wordsHarsh words, abusive language, and other unpleasantness ''can'' happen.  But it doesn't ''usually'' happen on Citizendium, and it doesn't ''have'' to happenPolite discussion is keyWe can avoid unpleasantness as a rule because we are all committed to working togetherWe know that working together means changing other people's work, making compromises, or (far better) coming up with a creative solution that satisfies everyoneThe fluid nature of the text and writing allows for such creative, positive solutions.


Working so closely with others often requires sensitivity and finesseYou might have deleted a sentence it took someone else five minutes to craft, so why doesn't the person become quite angry and stalk away, or abuse you?  Well, such unpleasantness ''can'' happenBut it doesn't ''always'' happen, and it doesn't ''have'' to happenPolite discussion is key.  We can avoid unpleasantness as a rule because we are all committed to working togetherWe know, in turn, that working together means changing other people's work, making compromises, or (far better) coming up with a creative solution that satisfies everyone very wellThe fluid nature of the text allows for such creative, positive solutions, and it's precisely the expectation of such solutions that allows us to avoid conflict.
To collaborate effectively, please look at the talk page regularlyBe polite and respectfulIf you are angry, calm down and take a break before you write or do something rashAnd if you are dealing with a person who really is unreasonable, do not "take matters into your own hands" by cussing the person out, but ask a constable to intervene (at [email protected])That's what they're there for--to calm folks down and come to a sensible solution to complex problems of interaction.   


To collaborate effectively, keep a few things in mind: look at the talk page regularly.  Be polite and respectful.  If you are angry, calm down and take a break before you write or do something rashAnd if you are dealing with a person who really is unreasonable, do not "take matters into your own hands" by cussing the person out, but ask a constable to intervene (at [email protected]).  That's what they're there for--to calm folks down and come to a sensible solution to complex problems of interaction.  They are also authorized to ban abusive people.
== We need to collaborate more ==
Many articles, especially from newer recruits, could obviously use help of a sort that would be obvious to any of "the regulars." If you are concerned about the project being as good as it can be, then please review [[Special:Recentchanges|recent changes]] regularly, linked on the left side of every wiki page and "poke in" and see what others are doing.  Give both positive feedback and constructive criticismIf you notice that a new person is misusing categories or templates, or uploading something that isn't an encyclopedia article, or committing some other little error, just give a little (polite) guidanceA friendly word or two goes a ''long'' way.


Also, if you see an article that someone is evidently working hard on, that piques your interest--then ''you'' can dive into editing the article.  It isn't owned by its main developer.  Of course, it's always best to understand the narrative under development--so, read the article--and to make your contributions as high-quality as possible, but nobody owns any article.


---------
== But we can't ''expect'' collaboration ==
Bottom-up, unassigned, at-will collaboration means that you can't expect others to help out.  They will if they want to.  You, who would like comments on your work, might not think of comments on your contributions as "work," but commenters might view it that way if it was something they felt obliged to do.


== Text to adapt and add to the above ==
== How to get collaborators ==


===============================
If you want collaborators and don't have any, you can:
1. We need to collaborate more.


First, a general point.  There really should be more collaboration, period, on the wiki.  I know I've been encouraging people to start new articles (with some success I might add; we'll pass 3,800 today)--but not to the exclusion of helping others with *their* articles.  I've noticed many articles, especially over the last five days with many new people arriving, that could obviously use help of a sort that would be obvious to any of "the regulars."  (Since I've been focused elsewhere, I haven't been able to give these articles the treatment I think they deserve, as I normally might.)
* Post to [[CZ:Feedback_Requests|Feedback Requests]].


I don't mean to tell you what to do, but if you are concerned about the project being as good as it can be, then my advice would be to review recent changes regularly, linked on the left side of every wiki page, direct URL
* Ask individual editors for comments.  Consult the [[CZ:Workgroups|Workgroups page]] for lists of authors in different subjects.  This might help bring them out of the woodwork, you know.  It's something we particularly encourage!
here:


http://en.citizendium.org/wiki/Special:Recentchanges
* Seek help in the Content forum.


and "poke in" and see what others are doing.  In the past, I've spent a large part of every day doing this--it's crucial.  Give both positive feedback and constructive criticism.  If you notice that a new person is misusing categories or templates, or uploading something that isn't an encyclopedia article, or committing some other faux pas, just give a little
== Editors need to be bold ==
(polite) guidance.  A friendly word or two goes a *long* way.


Also, if you see an article that someone is evidently working hard on, that slightly piques your interest--maybe "bowling"
It is possible that what keeps a lot of editors from getting involved is that they are thinking of CZ articles as "someone else's inviolable text." That would be the case if we were constructing an ''anthology'' using a wiki, where each person is responsible only for his or her own assigned pages, and no one does anything else other than offer feedback.  But CZ isn't an anthology.


http://en.citizendium.org/wiki/Bowling
Instead, we are engaged in  "strong collaboration."  That means that no individual or group of individuals is assigned to work on an article; the group of people who happen to work on an article is (or can be) ever-changing; people decide individually which article they want to work on; it isn't decided from above.  (For more about this concept, [http://www.textop.org/TextAndCollaboration.html#collab see here.])


would be an example--then you should bear in mind that *you* can dive into editing the article.  It isn't owned by its main developerOf course, it's always best to understand the narrative under development--so, read the article--and to make your contributions as high-quality as possible, but nobody owns any article.  If you think you do, you're sadly mistaken.
* It really is all right for you to edit someone else's text.  It is not an insult or a violation of anybody's rights to have their text editedIn fact, it's usually received as a sort of compliment.  (See [[CZ:Group Editing|Group Editing]] for more, and [http://blog.citizendium.org/2007/04/11/a-simple-explanation-of-why-people-like-to-write-for-wiki-encyclopedias/ this blog post] for more about the psychology here.)


=======================================
* Editors (and authors), it's all the more OK for you to ''comment'' on someone else's text, on the talk page.
2. But we can't *expect* collaboration.


Bottom-up, unassigned, at-will collaboration means that you can't expect others to help out.  They will if they want to.  But you don't understand the dynamic behind CZ (and other successful wiki projects) if you are tempted to leave in a huff because no one is commenting on your work.  If we
== But editors also need to be open to collaboration ==
*required* anyone to comment on your work, a lot less commenting, period, would be happening.  The amount of work that gets done is a direct result of the fact that no one is assigning it.  You, who would like comments on your work, might not think of comments on your contributions as "work," but commenters might view it that way.
The flip side to the failure to understand the nature of wiki collaboration, on the part of ''some'' editors, is that when someone does get involved, they start to as it were "claim ownership" over what they're working onThis not only drives away other contributors, it is contrary to our community values.


(Of course, we'd like it all to be not work but funBut maybe it isn't always:-) )
Just remember, garbage isn't permanent.  The existence of a little bad writing, bias, and inaccuracy is not an emergency that must be fixed immediately, at the cost of lost contributors.  It should be removed, to be sure, but it is more important that we retain our fellows and keep them motivatedIt's not an either-or proposition, eitherWe can politely correct our fellows without driving them off.


============================
As a rule of thumb, it is better to discuss what is wrong with a piece of text on the [[CZ:Talk Pages|talk page]] before you hack it to bits, and give the others a chance to respond first.  Giving notice in this way isn't necessary if you are making small edits, but if there is any "hacking" going on, it ''is'' necessary; it certainly helps smooth the wheels of discourse.  Sometimes the criticized party  will make the necessary changes themselves.  Sometimes, they'll be upset and will need calming down; you'll have to negotiate.  Of course, you needn't ask permission before you ''add to'' an article.  It's ''deleting'' or ''drastically altering'' that needs advance explanation. Again, you aren't asking "permission," as if there were an owner who had to agree to your change.  Instead, you are explaining yourself for ''anyone'' who is interested; it's just a matter of courtesy.
3. How to get collaborators.


If you want collaborators and don't have any, you're not totally helpless, you knowConsider your options:
For large amounts of deleted text, we ''require'' a fairly detailed explanation at the same time (or just before) you make the deletionUnexplained deletion is actually contrary to our [[CZ:Professionalism|professionalism
policy]].


* Post to Feedback Requests: http://en.citizendium.org/wiki/CZ:Feedback_Requests
But we would prefer that people collaborate more actively, and make a few faux pas, than always "asking permission" and doing nothing.  In short, please practice active, exuberant collaboration, and be open to it.


* Post on your workgroup mailing list (list found under "communication"
{{Communication}}
link): http://en.citizendium.org/wiki/CZ:Mailing_lists
 
* Ask individual editors for comments.  Consult the Workgroups page http://en.citizendium.org/wiki/CZ:Workgroups for lists of authors in different subjects.  This might help bring them out of the woodwork, you know.  It's something I particularly encourage!
 
* Editors have recently agreed to let Citizendium-Editors be used for feedback requests.  So, editors, if you want to get input on an article or on a particular content question, you can always ask there.
 
* If you're *really* desperate, you can post your request on Citizendium-L, and reach 750+ people all at once!
 
Here's an idea.  If anyone would like to compile a list of the most recent additions to our Feedback Request page and post it to Citizendium-L every week, that would be great.  That's something anybody could do.  Please do! Don't ask for permission, just do it!  :-)  (For example, Martin Baldwin-Edwards has been doing this for our Articles of the Week, and no one had to ask him--thanks, Martin.)
 
===========================================
4. Editors in particular need to be bolder.
 
I strongly suspect that what keeps a lot of editors from getting involved is that they are thinking of CZ articles as "someone else's inviolable text." That would be the case if we were constructing an *anthology* using a wiki, where each person is responsible only for his or her own assigned pages, and no one does anything else other than offer feedback.  But CZ isn't an anthology.
 
Instead, we are engaged in what I have called "strong collaboration."  That means that no individual or group of individuals is assigned to work on an article; the group of people who happen to work on an article is (or can be) ever-changing; people decide individually which article they want to work on; it isn't decided from above.  For more about this truly revolutionary concept, see here:
 
http://www.textop.org/TextAndCollaboration.html#collab
 
Maybe this all seems obvious to anyone who knows much about wikis, but, again, I still think many editors seem not to grok the implications:
 
* It is all right for you to edit someone else's text.  It might have been written by someone else, but it is *shared* in common.  It is not an insult or a violation of anybody's rights to have their text edited.  In fact, it's usually received as a sort of compliment.  (See this blog post http://tinyurl.com/2vaadn for a little more about the psychology here.)
 
* Editors (and authors), it's all the more OK for you to *comment* on someone else's text, on the talk page.  This is *not* an imposition.  You should not wait to be invited to comment on articles in your area (or, for that matter, outside of your area, if you have something helpful to add).
 
=====================================================
5. But editors also need to be open to collaboration.
 
The flip side to the failure to understand the nature of wiki collaboration, on the part of *some* editors, is that when someone does get involved, they start to as it were "claim ownership" over what they're working on.  This not only drives away other contributors, it is actually contrary to our fundamental policies (http://en.citizendium.org/wiki/CZ:Fundamentals
III.3.).
 
This might upset some academics, who are not comfortable with sloppiness, temporary inaccuracy, or in short anything they feel is out of their control.  I'm afraid that a measure of by-the-seat-of-our-pants can't be helped, however.  If you want to make an omelet, you've got to break a few eggs.  If you want people to feel generally comfortable contributing, you have to be tolerant of, well, some crappy contributions.  This doesn't mean that we have to *keep* the crappy stuff (obviously we don't)--it merely means that we have to be so open as to allow a little crap to seep in from time to time.  This will help keep everyone maximally motivated, which is of paramount importance.
 
Just remember, crap isn't permanent.  The existence of a little bad writing, bias, and inaccuracy is not an emergency that must be fixed immediately, at the cost of lost contributors.  It should be removed, to be sure, but it is more important that we retain our fellows and keep them motivated.  It's not an either-or proposition, either.  We can politely correct our fellows without driving them off.  In fact, this practice has a good old name: tolerance.
 
As a rule of thumb, it is better to discuss what is wrong with a piece of text before you entirely hack it to bits, and give the others a chance to respond first.  Giving notice in this way isn't required, but it certainly helps smooth the wheels of discourse.  Sometimes the criticized party (if they're still around) will make the necessary changes themselves.  Of course, you needn't ask permission before you *add to* an article.  It's
*deleting* or *drastically altering* that could use advance explanation.
 
By the way, for large amounts of deleted text, we actually *require* a fairly detailed explanation at the same time (or just before) you make the deletion.  Unexplained deletion is actually contrary to our professionalism
policy:
 
http://en.citizendium.org/wiki/CZ:Professionalism
 
(See "Reversion and deletion as unprofessional behaviors.")

Latest revision as of 07:12, 28 April 2024

Citizendium is a collaborative community. Your knowledge, with the next person's, and the next, build and shape, re-build and re-shape, the articles of this compendium.

So, how do a bunch of strangers manage to create a coherent encyclopedia article? Generally, it's like this: you see that a sentence needs rewording; so you reword it. You see an article that needs a whole new section; so you add it. You find that an article has much flabby prose; so you make it concise. Or you just know a lot about a particular subject and see much to change; so you go through and make a thorough overhaul. Many people can do all of those things to the same article, and something excellent can result.

Working closely with others often requires sensitivity and finesse. You might have deleted a sentence it took someone else five minutes (or five hours) to craft. Resentment and anger are often the immediate responses when someone else changes "your" words. Harsh words, abusive language, and other unpleasantness can happen. But it doesn't usually happen on Citizendium, and it doesn't have to happen. Polite discussion is key. We can avoid unpleasantness as a rule because we are all committed to working together. We know that working together means changing other people's work, making compromises, or (far better) coming up with a creative solution that satisfies everyone. The fluid nature of the text and writing allows for such creative, positive solutions.

To collaborate effectively, please look at the talk page regularly. Be polite and respectful. If you are angry, calm down and take a break before you write or do something rash. And if you are dealing with a person who really is unreasonable, do not "take matters into your own hands" by cussing the person out, but ask a constable to intervene (at [email protected]). That's what they're there for--to calm folks down and come to a sensible solution to complex problems of interaction.

We need to collaborate more

Many articles, especially from newer recruits, could obviously use help of a sort that would be obvious to any of "the regulars." If you are concerned about the project being as good as it can be, then please review recent changes regularly, linked on the left side of every wiki page and "poke in" and see what others are doing. Give both positive feedback and constructive criticism. If you notice that a new person is misusing categories or templates, or uploading something that isn't an encyclopedia article, or committing some other little error, just give a little (polite) guidance. A friendly word or two goes a long way.

Also, if you see an article that someone is evidently working hard on, that piques your interest--then you can dive into editing the article. It isn't owned by its main developer. Of course, it's always best to understand the narrative under development--so, read the article--and to make your contributions as high-quality as possible, but nobody owns any article.

But we can't expect collaboration

Bottom-up, unassigned, at-will collaboration means that you can't expect others to help out. They will if they want to. You, who would like comments on your work, might not think of comments on your contributions as "work," but commenters might view it that way if it was something they felt obliged to do.

How to get collaborators

If you want collaborators and don't have any, you can:

  • Ask individual editors for comments. Consult the Workgroups page for lists of authors in different subjects. This might help bring them out of the woodwork, you know. It's something we particularly encourage!
  • Seek help in the Content forum.

Editors need to be bold

It is possible that what keeps a lot of editors from getting involved is that they are thinking of CZ articles as "someone else's inviolable text." That would be the case if we were constructing an anthology using a wiki, where each person is responsible only for his or her own assigned pages, and no one does anything else other than offer feedback. But CZ isn't an anthology.

Instead, we are engaged in "strong collaboration." That means that no individual or group of individuals is assigned to work on an article; the group of people who happen to work on an article is (or can be) ever-changing; people decide individually which article they want to work on; it isn't decided from above. (For more about this concept, see here.)

  • It really is all right for you to edit someone else's text. It is not an insult or a violation of anybody's rights to have their text edited. In fact, it's usually received as a sort of compliment. (See Group Editing for more, and this blog post for more about the psychology here.)
  • Editors (and authors), it's all the more OK for you to comment on someone else's text, on the talk page.

But editors also need to be open to collaboration

The flip side to the failure to understand the nature of wiki collaboration, on the part of some editors, is that when someone does get involved, they start to as it were "claim ownership" over what they're working on. This not only drives away other contributors, it is contrary to our community values.

Just remember, garbage isn't permanent. The existence of a little bad writing, bias, and inaccuracy is not an emergency that must be fixed immediately, at the cost of lost contributors. It should be removed, to be sure, but it is more important that we retain our fellows and keep them motivated. It's not an either-or proposition, either. We can politely correct our fellows without driving them off.

As a rule of thumb, it is better to discuss what is wrong with a piece of text on the talk page before you hack it to bits, and give the others a chance to respond first. Giving notice in this way isn't necessary if you are making small edits, but if there is any "hacking" going on, it is necessary; it certainly helps smooth the wheels of discourse. Sometimes the criticized party will make the necessary changes themselves. Sometimes, they'll be upset and will need calming down; you'll have to negotiate. Of course, you needn't ask permission before you add to an article. It's deleting or drastically altering that needs advance explanation. Again, you aren't asking "permission," as if there were an owner who had to agree to your change. Instead, you are explaining yourself for anyone who is interested; it's just a matter of courtesy.

For large amounts of deleted text, we require a fairly detailed explanation at the same time (or just before) you make the deletion. Unexplained deletion is actually contrary to our professionalism policy.

But we would prefer that people collaborate more actively, and make a few faux pas, than always "asking permission" and doing nothing. In short, please practice active, exuberant collaboration, and be open to it.


Citizendium Communication
Workgroups | Discussion forum | For non-members | Twitter

|width=10% align=center style="background:#F5F5F5"|  |}