Documents, pads and guides

TASK MANAGEMENT IN THE CONTENT AND TRANSLATIONS SUBAREA

Meetings: Fridays 11:00 am (every two weeks or when needed; they may be proposed by anyone, at least a couple of days in advance).

We use mainly GitLab and Agent to manage the evolution of tasks and OCP to validate and register them so they can be paid.

TO TAKE INTO ACCOUNT: Writers and translators should be registered in GitLab and OCP

WRITERS:

The language to write the contents will be English. It doesn't matter so much if you are not proficient, cos the result will always be checked by a native speaker. This is in order to facilitate the participation of more people in this tasks. Better to write short sentences and short paragraphs with simple different ideas in any of them. Always make sure that you write terms according to the style agreed in FairCoop:

  • FairCoop
  • Freedom Coop
  • FairMarket
  • FairCoin (when talking about the currency; always singular)
  • Faircoin (when talking about coins)
  • Use-FairCoin -etc.

TRANSLATORS:

  • Ideally, the translations shouldn't have to imply the need of any proofreading. Translators preferably speak the target language well, so better if they are native speakers or bilingual. When no native speakers are available, the doer should ideally look for someone proficient in the target language in order to revise the text.
  • When translating a text that includes some links, always try to substitute the original links for others in the target language you are writing, if possible.
  • Never translate proper names (OCP, Bank of the Commons, etc).
  • Be careful to respect the original formatting.

CONTENT CREATION PROCESS

  • Content for publication will come from different sources:

1. The facilitator will be aware of what “official” news needs to be published

  1. Anyone can put different proposals in the BACKLOG or propose them in the meetings

- The Content and Translation Group will decide in its Friday meetings which tasks are transferred from the BACKLOG to TO DO, and so, which ones will be budgeted each week. It should be done, depending on:

  • The urgency of each one.
  • The publication frequency established for the posts in the web (to make it more or less uniform). The ideal will be at the moment one post per week, to be published preferably every Thursday.
  • The budget available to remunerate them (in case this could be a problem at any time).
  • The facilitator will move them from the BACKLOG to TO DO.

When the tasks are in TO DO, the facilitator will:

  • open the corresponding pad to write the content
  • open the same tasks in GitLab and OCP
  • add the links to the pad and the OCP process to the task in GitLab
  • add the IN OCP label to the corresponding task so that the process is known to be available there
  • open the corresponding task for the designers in GitLab

The person who assumes the task will:

  • Assign it to herself and put the date for the task to be done (both things in the right column) Pass the task from TO DO to IN PROCESS

Once the task is done, the doer:

IN Gitlab:

  • Will comment in the comment box the work done to justify the time spent (if needed) and add the time spent in comments with no commands. Just like a normal comment (don't use the command /spend, here). Will move the task to the column TO REVISE (writers) or TO PUBLISH (translators)

IN Agent:

IN OCP:

  • Will assume the task in OCP (looking for it through the link to OCP in the instructions of the task) by clicking “I did some work on this”. Here it is important to check that the date is ok and to mark the time spent. Once this is done, the doer can go to kispagi in order to check that all has been registered accordingly. At the moment, the facilitator is taking care of the validation process of the tasks opened by her.

If a task is going to be done by more than one person:

  • One of them will take the task in GitLab. The collaboration of the other people will be mentioned in the section for comments on the corresponding task.
  • All of them will explain their work and the time spent in OCP trough the button I did some work on this
  • ANOTHER OPTION
  • Even if the sub-area has stated to use OCP to validate the tasks, still there is freedom for anyone to choose another option, such as VALIDATION IN GITLAB. For those who prefer to do it this way, these are the instructions:

To validate a task in GitLab instead of doing it in OCP, the doer should:

  • Not touch OCP at all
  • Indicate the time spent by writing in comments the command /spend xh, making sure that the amount appears in the right column under Time Tracking
  • Place the task in the column COMPLETED
  • Look for two validations from people in the communication area. The validators should write in the comments box the command: #validated
  • Once this is done, the task must be placed in the column OCW VALIDATED and leave it there till the task has been paid
  • Once paid, the doer should move the task to the column CLOSED