Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

ProleWiki:Editor onboarding: Difference between revisions

From ProleWiki, the proletarian encyclopedia
(clarified Trusted roles (migration is complete) and reordered a bit)
Tag: Visual edit
No edit summary
Tag: Visual edit
 
(31 intermediate revisions by 2 users not shown)
Line 3: Line 3:
This page is meant to help you get started on [[ProleWiki]] as quickly as possible, so please read it all the way through!
This page is meant to help you get started on [[ProleWiki]] as quickly as possible, so please read it all the way through!


== Socialise with the team==
'''Please give us feedback on this page!''' Join the discord or contact [[Comradeship:CriticalResist|CriticalResist]] on his talk page (click the link on his name). We can only improve this onboarding experience with your help!
 
<small>Reading time: {{#invoke:Reading time|estimateReadingTime|ProleWiki:Editor onboarding}}</small>
 
== Too long didn't read? ==
First thing: '''please read everything''' on this page! But if you can't, here's the bullet point list of everything that's on this page.
 
# If you're a library or learning editor, you have special restrictions in place. Please read the associated sections for more information.
# Join the [https://discord.gg/ZQTBNRU9v5 Discord] if you have it (or [https://matrix.to/#/%23prolewiki:matrix.org matrix]) to make communication easier. Just give us your ProleWiki username in vetting, don't answer the questions.
# Remember we write '''for the reader''', who are not necessarily communists.
# Read our [[ProleWiki:Editorial guidelines|editorial guidelines]], they explain the style we use and how we format things.
# '''Source everything.''' We will revert edits which are not sourced properly until they are, we have a team that patrols new edits and validates them, they will notify you if they revert your edit and why.
# The only claims you don't have to source are <u>common sense</u> claims: things people (not communists, but general people) would reasonably not care to look up. E.g. a person's full name or date of birth, or the list of countries in the EU. Vague, general claims such as "The revolution brought many changes to the country" also don't have to be sourced. Everything else should be.
# We don't shy away from '''criticizing''' parties and public figures when we need to on our pages, but always as a struggle session. Leave personal opinions out and make sure it's not petty drama but is important to know for the reader.
# '''Clean up after yourself''': you are responsible for formatting, proofreading, properly sourcing, etc. all edits you make. We don't have any janitors, so you're expected to do this yourself to maintain quality across all pages. Essentially, all editors are also moderators and the wiki is largely self-governed.
# '''Governance''': ProleWiki is governed currently by [[:Category:Administration|four admins]] who pick up tasks that haven't been delegated to editors yet. You can volunteer to pick up a task.
# If you have '''skills''' you think may be useful to ProleWiki or have an idea you want to develop (e.g. a project you'd be interested in doing for ProleWiki), please reach out to the admins and they'll help you set it up.
# We also have a [[ProleWiki:Library|library]] and [[ProleWiki:Essays|essays]] space you can participate on. Both managed by [[Comrade:420dengist|420dengist]].
# Please don't edit others essays unless you have permission from the author. Open source essays can be edited by anyone (author is "Open source").
# '''Trusted role''': make enough edits and stay active for a while and the administration will give you the [[ProleWiki:Trusted Editor Permissions|trusted]] role. It's not a badge of honor, it's a mark of being active on the Wiki and being involved. It will let you vote on finances, account requests, create pages and upload files.
# '''User guide''': don't know how to do something in the editor? Refer to [[ProleWiki:User guide|this guide]].
# We '''promote democracy''' and evolve rapidly! What you read now on this page may already be outdated! (But we try to keep it updated)
# In case of '''conflict with editors''': please contact the admins. Don't get into edit wars or let things stew. See [[ProleWiki:Code of conduct|Code of conduct]].
# And most of all: have fun! We have a friendly community that you're now a part of!
 
== For library editors ==
Starting in November 2023, we started allowing library editors on ProleWiki. You'll know if you're a library editor as this will have been discussed with you before your account was approved. But for simplicity's sake, we included all the information for library editors in this page.
 
Whether you've been approved to become a full editor or a library editor, please read this entire page regardless!
 
Becoming a library editor means that you can only edit [[ProleWiki:Library|library]] pages, that is, books and documents we host. Some common tasks of library editors include:
 
* Adding new books to the library (check [[ProleWiki:User guide#Adding works to the Library|user guide]] on how to do that).
* Adding infoboxes to works (See 'templates' [[ProleWiki:User guide#Templates|here]], it's the ''Library Work'' template).
* Correcting typos and other OCR artefacts that may be present in books.
* Categorizing works correctly, and suggesting new categories and categorization methods.
* Making suggestions on the library! Any suggestion you might have is good to hear, so don't hesitate to share.
 
This work is mutually beneficial, but rest assured there's no quotas to fill or hours to put in: you participate when you want, we're not going to come after you if you take a break. On the one hand, it allows you to get to know us (and vice versa) and learn how ProleWiki works. It also allows you to read the books you upload and therefore become more theoretically proficient. On our end, it helps us fill the Library with more works. Down the line, once you've learned more theory, you can try vetting again and hopefully become a full editor!
 
For any question in the course of this work, please contact [[Comrade:420dengist|420dengist]] who manages our library, or the administration. As a library editor, we require you to join either the Discord or Matrix servers (see next section) so that we can more easily communicate with each other. Don't worry, we're friendly!
 
== For learning editors ==
As a learning editor, your edits will be submitted for moderation after they are made. This means that you can edit any page, but your edits will join a moderation queue which is monitored and reviewed by the Trusted editorship. They are usually approved very quickly.
 
Your moderated edits might be approved and then undone, reverting the page you edited to the version prior to your edit. This will likely happen because your edit was substantial and we didn't want to simply delete it into the void, but it might be missing some important requirements such as sourcing or proofreading. All edits that were saved to the wiki can be easily found again by clicking "View History" on any page.
 
The point of restricting edits is not to punish our learning editors, but to make sure the information published on ProleWiki is accurate, factual, and authoritative. If you've been accepted as an editor, it means the editorship considered you have knowledge to share in some topics. But we can't all be perfect, and it's natural that some areas of your knowledge might not be as developed as others. We will also try to help you learn and discuss your edits so you may progress as a marxist.
 
As a learning editor, we require you to join either our Discord or Matrix server (see next section) so that we can more easily communicate with each other.
 
== Socialize with the team==
We recommend that you join our Discord here: https://discord.gg/ZQTBNRU9v5
We recommend that you join our Discord here: https://discord.gg/ZQTBNRU9v5


Since you have an approved account on the wiki, when opening a ticket on the Discord just give us your account name from the Wiki and you'll get in. The Discord is where most of the communication happens, including between editors.
Our Discord is where most of the discussion happens, and you will usually receive an answer faster there.
 
When opening a ticket on the Discord, just give us your account name and you'll get in.


We also have a Matrix space if you prefer that, but while we check it, it's rarely used: https://matrix.to/#/%23prolewiki:matrix.org
We also have a Matrix space if you prefer that, but while we check it, it's rarely used: https://matrix.to/#/%23prolewiki:matrix.org
Line 18: Line 71:
*Reddit: https://reddit.com/r/prolewiki
*Reddit: https://reddit.com/r/prolewiki


'''Do you have socials too?''' Make them known! We'll follow you and like your content, and you can also tweet out the edits you've made to the wiki (and maybe even tag us!)


==Before you start writing...==


Currently, the administrators of ProleWiki are [[Comrade:CriticalResist|CriticalResist]] and [[Comrade:Forte|Forte]].
=== Editorial guidelines ===
Please familiarize yourself with our Guidelines: [[ProleWiki:Editorial guidelines]] so as to help retain a cohesive look to the encyclopedia.


==Understanding "Trusted" editors ==
Generally, you will start to internalize our editorial feel from reading the encyclopedia and seeing how it's usually written.
When your account is approved on the wiki (and you've received the email linking you to this page), you have no specific role aside from being a vetted user.
 
While we got some inspiration from Wikipedia in some areas, we don't entirely rely on them and it's not possible to translate Wikipedia's guidelines and conventions 1:1 onto ProleWiki. Wikipedia is an anti-communist encyclopedia with its own share of problems, and while we took inspiration from what worked (as they've had two decades to refine their editorial conventions), our similarities don't go further than that.


As a new editor to ProleWiki, you have the following permissions:
Likewise, when you start writing, please do not copy content straight from outside sources — we don't need to plagiarize and are perfectly capable of writing our own content!


* Editing existing pages
=== Source everything ===
*Creating new topics in the Talk pages and replying to them
There is no such thing as adding too many sources so please source every claim you make (with more than one source even)!
----As you make edits (either in ''quality'' or ''quantity''), the administration ([[Comrade:CriticalResist|CriticalResist]] and [[Comrade:Forte|Forte]]) will give you the '''Trusted''' role, which will allow you to create ''new'' pages as well as ''upload'' images.


If you feel that you've participated enough, you can freely ask the admins to review your account and grant you the Trusted role. We are sometimes overloaded with work and forget who has not received their Trusted role. If you feel we've forgotten about you, please shoot us a message!
'''Since January 2024''', we've become much more strict in regards to sourcing. Now, edits which are not properly sourced will be reverted. In that case, you will be notified by the patrol team (see users with [https://en.prolewiki.org/index.php?title=Special:ListUsers&group=delegate delegate role]). Any reverted edit is still accessible from the "View History" button so you can find it again when you're ready to add sources.


The Trusted role will also let you propose new policies for ProleWiki and vote on them with the other editors (usually in the Discord).
The only claims you don't have to source are "common sense" claims: things which we can reasonably expect ''people'' (not communists, but anyone) to not bother looking up. For example, names and dates of birth don't need to be sourced because this information is generally trustworthy by default. Vague, general claims that are made to introduce a subject don't need to be sourced either. For example, writing "The revolution brought many changes to the country" ought to be considered common sense: obviously, a revolution brings many changes. However, specifying "The revolution brought many social changes to the country such as: ..." would require a source for the specific claims.


Essentially, the trusted role makes you a full-fledged editor of ProleWiki and the permissions before that are sort of a trial period (don't worry, you can't fail this "trial period").
Remember we are writing '''for the reader''' and so pages should make sense to them.


This period also lets you explore and discover ProleWiki and our many (more than 2500!) pages. It helps cut down on duplicate pages and helps us see who remains active with ProleWiki.
=== How to write polemics ===
----In the meantime and until you get your Trusted status, you can ask the administration or other editors to create a page for you as needed; either on the Matrix or the [https://discord.gg/ZQTBNRU9v5 Discord] would be easiest.
We strongly believe in self-criticism and struggle sessions when it comes to the content of wiki pages. This works both for 1- what you write and 2- the actual content that you write.


On the Discord, which is where most of our off-site activity happens, you will get the Member role when you join. Then, at the same time we'll give you the Trusted role on the wiki, we will give you the Trusted Editor role on the Discord which will give you access to the editor channels (otherwise, you'll only have access to the "public" channels).
# After making an edit, please don't take it personally if another editor comes through afterwards and corrects or undoes parts of what you've written. We work together to improve the wiki for the reader.
# On the content of pages, we don't shy away from criticizing parties, organizations and public figures and denounce their tendencies that need to be denounced. ProleWiki itself has editors from all over the world and no allegiance towards a specific party or figure, which is our strength. However, please remember that people will associate your edits with '''ProleWiki itself'''! As such, please refrain from editing personal opinions or beliefs inside pages. While we don't have a "No Point-of-view" or "no original research" policy as strict as Wikipedia, remember that people who read ProleWiki will associate your (individual) edits as something the ''encyclopedia'' (i.e. all of us) says.


This role will also allow you to vote on new account requests which we often post on the Discord, and it will allow you to help decide what we do with our donations excess (if anything).
When writing polemics especially, please source claims as much as you can and be as accurate as possible in your wording. One way to think about it and guide your writing is to think: a- if I showed this to anyone in the world, would they believe me? and b- would I feel confident in showing this to the subject in person?


===Until you have these permissions...===
=== Clean up after yourself ===
Until you get the Trusted permissions, we recommend that you edit existing pages to add content or even rewrite paragraphs to help the flow of reading. You can also add categories to our pages, add sources to claims, and correct typos and proofread.
Essentially, cleaning up after yourself means that you are responsible for proofreading, sourcing, and following the editorial guidelines when you make an edit. While other editors might eventually patrol edits to correct typos or fix formatting, we don't have the capacity currently to proofread every edit. As such, we rely on each editor to make sure that they check up on both format and content before publishing their edits.  


Remember that as a proletarian encyclopedia, we strive to make our content easily accessible in all ways possible.
This also implies that you are allowed and encouraged to completely rework a page when you've brought substantial additions to it. Sometimes, information is repeated twice: once in your substantial edit, and once before in a later section. In that case, we encourage you to read through the whole page and rework it to fix internal links (bluelinks and redlinks should only appear on the first instance of the term), duplicate data, rewording for legibility, etc. on prior edits that might not have been made from you!


If you need to find sources for your editing, see the following pages:
=== User guide ===
We are writing an exhaustive user guide on how to edit Prolewiki. Please find it here: [[ProleWiki:User guide]].


*[[ProleWiki:How to contribute/Sources]] (books)
This page will teach you how to use ProleWiki autonomously like a pro. It's also a good reference guide if you don't know how to do something or forgot. Please check it before asking a question about using the editor, and if the User Guide didn't answer your question, then please ask other editors so that we can update the User Guide.
* [[:Category:Anti-imperialist news outlets]] (articles)
*[[:Category:Socialist media outlets]] (articles)
*[[Special:WantedPages]] (pages which are linked on the wiki but do not exist yet)


==Before you start writing...==
== Governance ==
Please familiarize yourself with our Guidelines: [[ProleWiki:Editorial guidelines]] so as to help retain a cohesive look to the encyclopedia.
The current governance structure of ProleWiki can be seen [[ProleWiki:Governance|here]].


Generally, you will start to internalize our editorial feel from reading the encyclopedia and seeing how it's usually written.
Administrators do technical and political work inside the project. The technical work is to maintain and configure the server and its files. Politically, the administration takes on a role of mentoring and guidance rather than a directive role, helping editors build consensus. The administrators still retain a right of veto, as their role is to keep ProleWiki in line with our [[ProleWiki:Principles|principles]] and avoid deviation from them.


While we got some inspiration from Wikipedia in some areas, we don't entirely rely on them and it's not possible to translate Wikipedia's guidelines and conventions 1:1 on ProleWiki. Wikipedia is an anti-communist encyclopedia with its own share of problems, and while we took inspiration from what worked (as they've had two decades to refine their editorial conventions), it doesn't go further than that.
Editors can join or be added to certain groups based on demand and interest. But some groups, due to the sensitivity of the work, cannot be joined freely. This is the case of technical work and our internal security group. Technical work is currently at the hands of the administrators, while the internal security group is composed of trustworthy editors hand-picked by the administrators. The group was created during a period of infiltration and wrecking attempts against our project, during which some editors were chosen due to the help they provided.


Likewise, when you start writing, please do not copy content straight from outside sources—we don't need to plagiarize!
There are currently no moderators either on the Discord or the Wiki.


Talk pages are unique to MediaWiki. For example, here you have the page: [[Socialism with Chinese Characteristics]], and here you have the talk page: [[Talk:Socialism with Chinese Characteristics]]. These talk/discussion pages are available on every page on the wiki, including editor pages, articles, essays, library works, etc. There you can ask any questions before making an edit if you're unsure about something.
ProleWiki is evolving very quickly however, and this structure might have changed by the time you read this onboarding page (though we try to keep the page updated).


Please remember that people will associate your edits with '''ProleWiki itself'''! As such, please refrain from editing personal opinions or beliefs inside pages. While we don't have a "No Point-of-view" or "no original research" policy as difficult as Wikipedia, remember that people who read ProleWiki will associate your (personal) edits as something the ''encyclopedia'' (i.e. all of us) says.
For more information, also read the next section: Understanding "Trusted" editors.


===How to create a new page===
==Understanding "Trusted" editors ==
Once you've received the permissions to create a new page, you will likely wonder how to do this. It's a bit cumbersome, and there's a few different ways, none of them intuitive.  
As you make contributions or edits (either in ''quality'' or ''quantity'') to ProleWiki as a whole, the administration will give you the '''Trusted''' role, which will allow you to create new pages as well as upload images. Getting the trusted role usually takes a few weeks to a month of active editing.


The easiest way to create a new page is to search for it: you can use the magnifying glass icon on the left sidebar or just find it here: https://en.prolewiki.org/index.php?title=Special%3ASearch&search=page. Search for the page you want to create (please remember ProleWiki is '''case-sensitive!''') and it will tell you, near the top of the page:
If you feel that you've participated enough, you can freely ask the admins to review your account and grant you the Trusted role. We are sometimes overloaded with work and forget who has not received their Trusted role. If you feel we've forgotten about you, please shoot us a message!


*Create the page "[[page]]" on this wiki! See also the search results found.
Read this page for more information on what being Trusted means: [[ProleWiki:Trusted Editor Permissions|Trusted Editor Permissions]].


Then, you can simply click on the red link that the search page shows you to start editing this new page you want to create. Don't forget to save your edit even if you haven't added much!
You should think of your period before receiving the role as a "tutorial" period, where we help you become an autonomous editor.
[[File:Edit button.png|thumb|The look of the Edit button using our default theme (you can change your theme on your user settings page)]]
What we mean by '''case-sensitivity''' is that [[Michael Parenti]] is not the same as [[Michael parenti]]! You can see the first one is blue (i.e. the page exists) and the second is a redlink, the page doesn't exist. This is a problem inherent to MediaWiki.


To get around this, it's necessary to create redirections, which we won't get into in this onboarding page.
If you are a library or learning editor, you might not be eligible for the Trusted role right away and might have to pass through the 'new' editor phase before receiving your Trusted role.
----In the meantime and until you get your Trusted status, you can ask the administration or other editors to create a page for you as needed; either on the Matrix or the [https://discord.gg/ZQTBNRU9v5 Discord] would be easiest.


We recommend using the visual editor if you are new to MediaWiki; it will open by default when you click on "edit" on a page.  
However, please limit your new pages! We prefer that you focus on one (new) page at a time so that we limit the amount of stubs on the wiki.


==We have more than just encyclopedic pages! ==
===Until you have these permissions...===
We have a space for free-form [[ProleWiki:Essays|Essays]] and you can write whatever you want in those pages (within reason), our guidelines don't apply.
Until you get the Trusted permissions, we recommend that you edit existing pages to add content or even rewrite paragraphs to help the flow of reading. You can also add categories to our pages, add sources to claims, and correct typos and proofread.


We also have a [[ProleWiki:Library|Library]] of texts where you can add Marxist and non-marxist (but socialist) texts.
Remember that as a proletarian encyclopedia, we strive to make our content easily accessible in all ways possible.


Finally, we have started a [[ProleWiki:Quotes|Quotes]] space where you can post quotes from Marxist theorists. We don't use it a lot, but we've identified that this is something people look for online and so it's interesting to have it on the wiki. It is also useful to have quotes to pull from when writing pages sometimes.
If you need to find sources for your editing, see the following pages:


All of these spaces you can edit in and add or correct pages in them.
*[[ProleWiki:How to contribute/Sources]] (books)
* [[:Category:Anti-imperialist news outlets]] (articles)
*[[:Category:Socialist media outlets]] (articles)
There is no such thing as too many sources comrades, so please add them as you write!


=== How to add an essay ===
If you're not sure what to edit check these pages for inspiration:
MediaWiki, the software which we use to power ProleWiki, can be confusing. We've covered how to create a new page (once you have the Trusted role), but adding an essay, while similar, requires an extra step. Nothing too difficult though!


First, you have to create your essay in the same way we created a page earlier. However, you have to preface the title of your page with '''Essay:'''
* [[:Category:Stubs]] (stubs -- articles that are very short)
* [[Special:ShortPages|Short pages]]
* [[Special:WantedPages|Wanted pages]] (pages that are linked on other pages but do not exist yet. You will need a "trusted" editor to create these pages for you).


It will look like '''[[Essay:Problems with Maoism]]''', for example.
==We have more than just encyclopedic pages! ==
We have a space for free-form [[ProleWiki:Essays|Essays]], in which you can write whatever you want (within reason); our editorial guidelines don't apply there.


You can use the search function like we did before to create this page, as long as you use the Essay: prefix (or namespace in MediaWiki terms).
Please don't edit other editors' essays without their permission; Open source essays can be freely edited and you are in fact encouraged to contribute to those (the author will be marked as "Open source")!


Then, write your essay and save your edit. Once your essay is completed, you need to add it to our [[ProleWiki:Essays|Essays]] page. To do that, open that page and edit it. Add your name in the table (in alphabetical order) and, on the next row, type in your Essay's title and link to it (ctrl+k on the visual editor). To link it, you can just paste the URL or look for it in the link field by typing Essay:name (you have to type the namespace for the field to find it).
We also have a [[ProleWiki:Library|Library]] of texts where you can add Marxist and non-marxist (but socialist) texts.


Then just save your edit.
Finally, we have started a [[ProleWiki:Quotes|Quotes]] space where you can post quotes from Marxist theorists. We don't use it a lot, but we've identified that this is something people look for online and so it's interesting to have it on the wiki. It is also useful to have quotes to pull from when writing pages sometimes.


It's a bit involved, but once you've done it a couple times, it'll come naturally.
While you are unable to directly create pages in those spaces until you get your permissions, you can ask other editors or the administration to create such pages for you.


==In case of conflicts with edits or editors ==
==In case of conflicts with edits or editors ==
Please note that ProleWiki is a collaborative encyclopedia and as such we all volunteer here to promote a proletarian education. Therefore, please don't take it personally if another editor edits a page you made.
Please note that ProleWiki is a collaborative encyclopedia and as such we all volunteer here to promote a proletarian education. Therefore, please don't take it personally if another editor edits a page you made.


If you have any issues with another editor, please use either the [https://discord.gg/ZQTBNRU9v5 Discord] (if they are on it) or the talk pages; e.g. the editor's talk page or the page's talk topics. Please remember to be polite and assume good faith from the editor you are having an issue with.
If you have any issues with another comrade, please use either the [https://discord.gg/ZQTBNRU9v5 Discord] (if they are on it) or the talk pages; e.g. the comrade's talk page or the page's talk topics.


Administrators are here to facilitate discourse and conflict resolution if you have any issues.  
Administrators are here to facilitate discourse and conflict resolution if you have any issues, don't hesitate to contact them.  


==Join our work groups!==
=== Code of Conduct ===
Once you become a trusted editor, you can propose or join our various work groups! Work groups are a system we've been trying out since early 2023, and it has worked with great success.
We have a Code of conduct here: [[ProleWiki:Code of conduct]]. In a nutshell, please respect the principle of comradeship and assume good faith from them in case of conflicts.


For example, one of our editor has started a book club on the [https://discord.gg/ZQTBNRU9v5 Discord] which you can absolutely join and participate in (as well as help manage). We also have an agitprop group which is responsible for social media creations and posting.
==If you have any questions==
 
Again, we cannot emphasize enough that you should join the [https://discord.gg/ZQTBNRU9v5 Discord]! It will allow you to talk to the other editors and ask your questions as needed. We understand though that not everyone likes to use Discord, and so you can also ask on our [[ProleWiki:Hub|Hub]] or, if needed, directly on our Administrators' talk pages if there's anything you don't understand or would like to know.
For transparency, we have an internal security group which cannot be joined; the administrators pick trustworthy members to fit in this group. The internal security group is responsible for defending against threats (hacking, spam waves, infiltration...) as well as monitor our reputation online. It is not a group meant to spy or keep tabs on our editors.  


As a trusted editor, you will be able to join or suggest new groups which the administration will help you set up. With this system, you can then work on things other than pure copywriting and get involved in things that interest you!
Have you read the whole document? Why not head on over to the talk page and create a topic to say hello as your first edit? You'll find the talk page by clicking on "Discussion" in the upper-right corner of this page.
 
==If you have any questions==
Again, we cannot emphasize enough that you should join the [https://discord.gg/ZQTBNRU9v5 Discord]! It will allow you to talk to the other editors and ask your questions as needed. However, if you have questions, you can ask on our Hub: [[Hub|https://en.prolewiki.org/wiki/Hub]] or, if needed, directly on our Administrators' talk pages if there's anything you don't understand or would like to know.
[[Category:ProleWiki official pages]]
[[Category:ProleWiki official pages]]

Latest revision as of 21:38, 5 October 2024

Hello new editor and welcome!

This page is meant to help you get started on ProleWiki as quickly as possible, so please read it all the way through!

Please give us feedback on this page! Join the discord or contact CriticalResist on his talk page (click the link on his name). We can only improve this onboarding experience with your help!

Reading time: 10-25 minutes

Too long didn't read?

First thing: please read everything on this page! But if you can't, here's the bullet point list of everything that's on this page.

  1. If you're a library or learning editor, you have special restrictions in place. Please read the associated sections for more information.
  2. Join the Discord if you have it (or matrix) to make communication easier. Just give us your ProleWiki username in vetting, don't answer the questions.
  3. Remember we write for the reader, who are not necessarily communists.
  4. Read our editorial guidelines, they explain the style we use and how we format things.
  5. Source everything. We will revert edits which are not sourced properly until they are, we have a team that patrols new edits and validates them, they will notify you if they revert your edit and why.
  6. The only claims you don't have to source are common sense claims: things people (not communists, but general people) would reasonably not care to look up. E.g. a person's full name or date of birth, or the list of countries in the EU. Vague, general claims such as "The revolution brought many changes to the country" also don't have to be sourced. Everything else should be.
  7. We don't shy away from criticizing parties and public figures when we need to on our pages, but always as a struggle session. Leave personal opinions out and make sure it's not petty drama but is important to know for the reader.
  8. Clean up after yourself: you are responsible for formatting, proofreading, properly sourcing, etc. all edits you make. We don't have any janitors, so you're expected to do this yourself to maintain quality across all pages. Essentially, all editors are also moderators and the wiki is largely self-governed.
  9. Governance: ProleWiki is governed currently by four admins who pick up tasks that haven't been delegated to editors yet. You can volunteer to pick up a task.
  10. If you have skills you think may be useful to ProleWiki or have an idea you want to develop (e.g. a project you'd be interested in doing for ProleWiki), please reach out to the admins and they'll help you set it up.
  11. We also have a library and essays space you can participate on. Both managed by 420dengist.
  12. Please don't edit others essays unless you have permission from the author. Open source essays can be edited by anyone (author is "Open source").
  13. Trusted role: make enough edits and stay active for a while and the administration will give you the trusted role. It's not a badge of honor, it's a mark of being active on the Wiki and being involved. It will let you vote on finances, account requests, create pages and upload files.
  14. User guide: don't know how to do something in the editor? Refer to this guide.
  15. We promote democracy and evolve rapidly! What you read now on this page may already be outdated! (But we try to keep it updated)
  16. In case of conflict with editors: please contact the admins. Don't get into edit wars or let things stew. See Code of conduct.
  17. And most of all: have fun! We have a friendly community that you're now a part of!

For library editors

Starting in November 2023, we started allowing library editors on ProleWiki. You'll know if you're a library editor as this will have been discussed with you before your account was approved. But for simplicity's sake, we included all the information for library editors in this page.

Whether you've been approved to become a full editor or a library editor, please read this entire page regardless!

Becoming a library editor means that you can only edit library pages, that is, books and documents we host. Some common tasks of library editors include:

  • Adding new books to the library (check user guide on how to do that).
  • Adding infoboxes to works (See 'templates' here, it's the Library Work template).
  • Correcting typos and other OCR artefacts that may be present in books.
  • Categorizing works correctly, and suggesting new categories and categorization methods.
  • Making suggestions on the library! Any suggestion you might have is good to hear, so don't hesitate to share.

This work is mutually beneficial, but rest assured there's no quotas to fill or hours to put in: you participate when you want, we're not going to come after you if you take a break. On the one hand, it allows you to get to know us (and vice versa) and learn how ProleWiki works. It also allows you to read the books you upload and therefore become more theoretically proficient. On our end, it helps us fill the Library with more works. Down the line, once you've learned more theory, you can try vetting again and hopefully become a full editor!

For any question in the course of this work, please contact 420dengist who manages our library, or the administration. As a library editor, we require you to join either the Discord or Matrix servers (see next section) so that we can more easily communicate with each other. Don't worry, we're friendly!

For learning editors

As a learning editor, your edits will be submitted for moderation after they are made. This means that you can edit any page, but your edits will join a moderation queue which is monitored and reviewed by the Trusted editorship. They are usually approved very quickly.

Your moderated edits might be approved and then undone, reverting the page you edited to the version prior to your edit. This will likely happen because your edit was substantial and we didn't want to simply delete it into the void, but it might be missing some important requirements such as sourcing or proofreading. All edits that were saved to the wiki can be easily found again by clicking "View History" on any page.

The point of restricting edits is not to punish our learning editors, but to make sure the information published on ProleWiki is accurate, factual, and authoritative. If you've been accepted as an editor, it means the editorship considered you have knowledge to share in some topics. But we can't all be perfect, and it's natural that some areas of your knowledge might not be as developed as others. We will also try to help you learn and discuss your edits so you may progress as a marxist.

As a learning editor, we require you to join either our Discord or Matrix server (see next section) so that we can more easily communicate with each other.

Socialize with the team

We recommend that you join our Discord here: https://discord.gg/ZQTBNRU9v5

Our Discord is where most of the discussion happens, and you will usually receive an answer faster there.

When opening a ticket on the Discord, just give us your account name and you'll get in.

We also have a Matrix space if you prefer that, but while we check it, it's rarely used: https://matrix.to/#/%23prolewiki:matrix.org

We also have other channels you can follow where we sometimes post announcements and other interesting things:

Do you have socials too? Make them known! We'll follow you and like your content, and you can also tweet out the edits you've made to the wiki (and maybe even tag us!)

Before you start writing...

Editorial guidelines

Please familiarize yourself with our Guidelines: ProleWiki:Editorial guidelines so as to help retain a cohesive look to the encyclopedia.

Generally, you will start to internalize our editorial feel from reading the encyclopedia and seeing how it's usually written.

While we got some inspiration from Wikipedia in some areas, we don't entirely rely on them and it's not possible to translate Wikipedia's guidelines and conventions 1:1 onto ProleWiki. Wikipedia is an anti-communist encyclopedia with its own share of problems, and while we took inspiration from what worked (as they've had two decades to refine their editorial conventions), our similarities don't go further than that.

Likewise, when you start writing, please do not copy content straight from outside sources — we don't need to plagiarize and are perfectly capable of writing our own content!

Source everything

There is no such thing as adding too many sources so please source every claim you make (with more than one source even)!

Since January 2024, we've become much more strict in regards to sourcing. Now, edits which are not properly sourced will be reverted. In that case, you will be notified by the patrol team (see users with delegate role). Any reverted edit is still accessible from the "View History" button so you can find it again when you're ready to add sources.

The only claims you don't have to source are "common sense" claims: things which we can reasonably expect people (not communists, but anyone) to not bother looking up. For example, names and dates of birth don't need to be sourced because this information is generally trustworthy by default. Vague, general claims that are made to introduce a subject don't need to be sourced either. For example, writing "The revolution brought many changes to the country" ought to be considered common sense: obviously, a revolution brings many changes. However, specifying "The revolution brought many social changes to the country such as: ..." would require a source for the specific claims.

Remember we are writing for the reader and so pages should make sense to them.

How to write polemics

We strongly believe in self-criticism and struggle sessions when it comes to the content of wiki pages. This works both for 1- what you write and 2- the actual content that you write.

  1. After making an edit, please don't take it personally if another editor comes through afterwards and corrects or undoes parts of what you've written. We work together to improve the wiki for the reader.
  2. On the content of pages, we don't shy away from criticizing parties, organizations and public figures and denounce their tendencies that need to be denounced. ProleWiki itself has editors from all over the world and no allegiance towards a specific party or figure, which is our strength. However, please remember that people will associate your edits with ProleWiki itself! As such, please refrain from editing personal opinions or beliefs inside pages. While we don't have a "No Point-of-view" or "no original research" policy as strict as Wikipedia, remember that people who read ProleWiki will associate your (individual) edits as something the encyclopedia (i.e. all of us) says.

When writing polemics especially, please source claims as much as you can and be as accurate as possible in your wording. One way to think about it and guide your writing is to think: a- if I showed this to anyone in the world, would they believe me? and b- would I feel confident in showing this to the subject in person?

Clean up after yourself

Essentially, cleaning up after yourself means that you are responsible for proofreading, sourcing, and following the editorial guidelines when you make an edit. While other editors might eventually patrol edits to correct typos or fix formatting, we don't have the capacity currently to proofread every edit. As such, we rely on each editor to make sure that they check up on both format and content before publishing their edits.

This also implies that you are allowed and encouraged to completely rework a page when you've brought substantial additions to it. Sometimes, information is repeated twice: once in your substantial edit, and once before in a later section. In that case, we encourage you to read through the whole page and rework it to fix internal links (bluelinks and redlinks should only appear on the first instance of the term), duplicate data, rewording for legibility, etc. on prior edits that might not have been made from you!

User guide

We are writing an exhaustive user guide on how to edit Prolewiki. Please find it here: ProleWiki:User guide.

This page will teach you how to use ProleWiki autonomously like a pro. It's also a good reference guide if you don't know how to do something or forgot. Please check it before asking a question about using the editor, and if the User Guide didn't answer your question, then please ask other editors so that we can update the User Guide.

Governance

The current governance structure of ProleWiki can be seen here.

Administrators do technical and political work inside the project. The technical work is to maintain and configure the server and its files. Politically, the administration takes on a role of mentoring and guidance rather than a directive role, helping editors build consensus. The administrators still retain a right of veto, as their role is to keep ProleWiki in line with our principles and avoid deviation from them.

Editors can join or be added to certain groups based on demand and interest. But some groups, due to the sensitivity of the work, cannot be joined freely. This is the case of technical work and our internal security group. Technical work is currently at the hands of the administrators, while the internal security group is composed of trustworthy editors hand-picked by the administrators. The group was created during a period of infiltration and wrecking attempts against our project, during which some editors were chosen due to the help they provided.

There are currently no moderators either on the Discord or the Wiki.

ProleWiki is evolving very quickly however, and this structure might have changed by the time you read this onboarding page (though we try to keep the page updated).

For more information, also read the next section: Understanding "Trusted" editors.

Understanding "Trusted" editors

As you make contributions or edits (either in quality or quantity) to ProleWiki as a whole, the administration will give you the Trusted role, which will allow you to create new pages as well as upload images. Getting the trusted role usually takes a few weeks to a month of active editing.

If you feel that you've participated enough, you can freely ask the admins to review your account and grant you the Trusted role. We are sometimes overloaded with work and forget who has not received their Trusted role. If you feel we've forgotten about you, please shoot us a message!

Read this page for more information on what being Trusted means: Trusted Editor Permissions.

You should think of your period before receiving the role as a "tutorial" period, where we help you become an autonomous editor.

If you are a library or learning editor, you might not be eligible for the Trusted role right away and might have to pass through the 'new' editor phase before receiving your Trusted role.


In the meantime and until you get your Trusted status, you can ask the administration or other editors to create a page for you as needed; either on the Matrix or the Discord would be easiest.

However, please limit your new pages! We prefer that you focus on one (new) page at a time so that we limit the amount of stubs on the wiki.

Until you have these permissions...

Until you get the Trusted permissions, we recommend that you edit existing pages to add content or even rewrite paragraphs to help the flow of reading. You can also add categories to our pages, add sources to claims, and correct typos and proofread.

Remember that as a proletarian encyclopedia, we strive to make our content easily accessible in all ways possible.

If you need to find sources for your editing, see the following pages:

There is no such thing as too many sources comrades, so please add them as you write!

If you're not sure what to edit check these pages for inspiration:

  • Category:Stubs (stubs -- articles that are very short)
  • Short pages
  • Wanted pages (pages that are linked on other pages but do not exist yet. You will need a "trusted" editor to create these pages for you).

We have more than just encyclopedic pages!

We have a space for free-form Essays, in which you can write whatever you want (within reason); our editorial guidelines don't apply there.

Please don't edit other editors' essays without their permission; Open source essays can be freely edited and you are in fact encouraged to contribute to those (the author will be marked as "Open source")!

We also have a Library of texts where you can add Marxist and non-marxist (but socialist) texts.

Finally, we have started a Quotes space where you can post quotes from Marxist theorists. We don't use it a lot, but we've identified that this is something people look for online and so it's interesting to have it on the wiki. It is also useful to have quotes to pull from when writing pages sometimes.

While you are unable to directly create pages in those spaces until you get your permissions, you can ask other editors or the administration to create such pages for you.

In case of conflicts with edits or editors

Please note that ProleWiki is a collaborative encyclopedia and as such we all volunteer here to promote a proletarian education. Therefore, please don't take it personally if another editor edits a page you made.

If you have any issues with another comrade, please use either the Discord (if they are on it) or the talk pages; e.g. the comrade's talk page or the page's talk topics.

Administrators are here to facilitate discourse and conflict resolution if you have any issues, don't hesitate to contact them.

Code of Conduct

We have a Code of conduct here: ProleWiki:Code of conduct. In a nutshell, please respect the principle of comradeship and assume good faith from them in case of conflicts.

If you have any questions

Again, we cannot emphasize enough that you should join the Discord! It will allow you to talk to the other editors and ask your questions as needed. We understand though that not everyone likes to use Discord, and so you can also ask on our Hub or, if needed, directly on our Administrators' talk pages if there's anything you don't understand or would like to know.

Have you read the whole document? Why not head on over to the talk page and create a topic to say hello as your first edit? You'll find the talk page by clicking on "Discussion" in the upper-right corner of this page.