-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Clone file CONTRIBUTING.adoc to the root of the repo
- Loading branch information
Showing
1 changed file
with
39 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,39 @@ | ||
= Authorship criteria and how to contribute to this document | ||
|
||
This document is open to participation. | ||
If you are familiar with Git and Pull Requests you can clone | ||
ifdef::_public_repo_url[{_public_repo_url}[the public repository]] | ||
ifndef::_public_repo_url[the public repository] | ||
and start contributing. | ||
Otherwise, you can contact us at hola@decidim.org. | ||
Please, have a look at our https://docs.decidim.org/editing-guide/en/latest/index.html[Documentation Editing Guide]. | ||
|
||
Your contributions may be of varying nature. | ||
The different authorship levels and criteria are stated below: | ||
|
||
Editors :: | ||
Responsible for monitoring a text and its versions, corrections and structure etc., and may or may not be one of the authors. | ||
In essence, an editor is someone who coordinates collaboration on the text. | ||
One of the editor's responsibilities is to request and read revisions. | ||
|
||
Authors :: | ||
Strictly speaking, authors are those who have drafted the text. | ||
The order of the authors listed reflects their contribution, with the first mentioned being the one who has written the most. | ||
Authors must have read and revised their text in its final or previous versions, although they do not have to agree with its final form, a task that falls to the editor. | ||
|
||
Contributors :: | ||
Two groups of contributors are considered here. | ||
On the one hand, the document's academic revisers (where they have made a considerable contribution) and, on the other, external collaborators whose contributions have been valuable and integrated in parts of the text included in the document. | ||
It is up to the editor and other authors to decide who is a contributor or an author, although the former is in any case meant to contribute less than the latter. | ||
As a general rule, a person who has written under 10% of the text ought to be considered a contributor rather than an author. | ||
By the same token, being a contributor means having written at least two or three paragraphs. | ||
|
||
Participants :: | ||
This is someone who has not contributed any specific text to the document but who has made valuable contributions such as observations about the document or provided valuable criteria, references or elements of discussion. | ||
|
||
Proofreaders :: | ||
Their work includes carefully reading an entire text, correcting errors and suggesting improvements. | ||
Such work is generally commissioned (requested from a person regarded as competent in the field), although it is possible for someone to contribute by proofreading a text that has not been explicitly requested. | ||
In such cases, the depth and quality of the proofreading process may qualify a person to be considered as a proofreader. | ||
|
||
This division and specification of authorship levels has been directly copied from the criteria established under http://floksociety.org/[the FLOK Society - Buen conocer] (see http://book.floksociety.org/ec/[Barandiaran et al. 2015], pp. 38-39). |