Translation of End-user documentation project started at WordCamp Torrelodones (Spain)


During the contributor day at WordCamp Torrelodones 2024, the Spanish documentation team started the translation for the end-user documentation.

The initial objectives were:

  • Decide the day and time for the weekly team meeting
  • Define responsibilities for meeting facilitators
  • Technical requirements for a documentation team member
  • How to effectively coordinate with the Spanish translation team
  • Review the Style Guide for translation
  • Define the translation process
  • Suggest new words to the Spanish (Spain) Glossary

Conclusions of the Spanish documentation team

Weekly meetings

  • The team is already meeting on Fridays at 09:00 UTC in the Spanish Slack channel #documentacion. The first meeting will take place on Friday 5 April 2024
  • The meetings will be announced in the Spanish Slack, same way as the global team does

Responsibilities for meeting facilitators

  • The team agreed that @estelaris will run the first few meetings and then it will be rotated among contributors
  • Whoever runs the meeting must prepare the agenda based on the previous meeting

Contributor technical requirements

  • Know sufficient English to understand the content that is being translated
  • Be familiar with the Spanish style guide and glossary
  • Basic understanding of GitHub

Translation Style Guide

Another goal is to improve the Spanish Style Guide to be able to write the documentation, following the rules already instilled by the translation team. This work will be based on the Documentation Style Guide written by the global team. Follow the work in GitHub Spain Handbook #288.

Translation process

The translation process the team will follow includes:

  • Update the style guide and have it reviewed and approved by the translation team
  • Prioritize articles for translation (high, medium, low) as well as add tasks to the issues (content, screenshots, videos, etc)
  • Work with #meta team to open the es.wordpress.org/documentacion site
  • Translate the articles and pass them to the Spanish polyglots team for review
  • Make the documentation available in Spanish from Spain as soon as the site is set

This post will be updated accordingly and it is a translation of the post in Make Spain Blog.

props to @josepmoran for taking notes during contributor day and to help write this post in Spanish

#contributor-day