Skip to content
Merged
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
77 changes: 77 additions & 0 deletions Translators_Guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# About the Guide

This guide is your companion throughout the DISCOVER Cookbook translation journey. Whether you're just discovering the project or have already been selected as a translator, this document will walk you through:

- How to apply and get accepted as a translator
- What tools and platforms you'll use (Transifex, Discord, GitHub)
- Step-by-step instructions for contributing translations
- How we’ll communicate and collaborate
- When and how your work will be acknowledged

---

## How to Become a Translator

We’re inviting volunteer translators to help make the DISCOVER Cookbook accessible to communities around the world. Here's how to join:

### 1. **Read the Blog Post:**

- The blog post serves as the official invitation to join the DISCOVER Cookbook translation project, outlining its mission to make inclusive event planning resources accessible across languages and cultures. It introduces the Cookbook’s purpose, explains the impact of translation, and calls for volunteer translators fluent in English and another language—while welcoming all language backgrounds. It also shares key dates, contributor benefits, and links to the application form and project resources, acting as the gateway for interested contributors to get involved and help communities worldwide.
- Learn about the project and its goals → [Become a Volunteer Translator](<link>)


### 2. **Explore the Cookbook:**

Familiarize yourself with the content → [DISCOVER Cookbook](https://discover-cookbook.numfocus.org/intro.html)


### 3. **Apply:**

Fill out the translator application form linked in the blog post
- **Deadline:** Sunday, September 14th, 2025 (AoE)
- **Notification:** Wednesday, September 24th, 2025 (AoE)


### 4. **Start Translating:**

The translation period runs from late September to the end of October.
- **Translation Period:** TBD
- **When the Contribution is Done:** TBA

---

## Onboarding & Access

Once selected, you’ll receive access for the following platforms:

- **Transifex:** Our translation management platform. You’ll receive an invite to join the DISCOVER Cookbook project.
- **Discord:** Our main space for real-time communication and collaboration.
- You’ll be added to a dedicated **Discord channel** for translators.
- **Email:** Important updates and reminders will be sent via email.
- **Meetings:** Optional check-ins or onboarding calls may be scheduled to support contributors.

---

## Instructions for Translators

### How to Use Transifex
Follow the official instructions here:
🔗 [GitHub Pull Request #371](https://github.com/numfocus/DISCOVER-Cookbook/pull/371)

### GitHub Repository
The source files and documentation are hosted on GitHub.
🔗 [DISCOVER Cookbook GitHub Repo](https://github.com/numfocus/DISCOVER-Cookbook)
Comment on lines +125 to +126
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The only file translators care about is this one and the glossary+translation guidelines (if we add them). I would link directly there. One of the goals of using transifex is making it easy for people with no github knowledge to participate, so the less they have to interface with github the better I think


### Acknowledgment
All contributors will be credited in accordance with the DISCOVER Cookbook license. Your name and language contribution will be listed in the final release.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The license doesn't really say anything about credit, it only mentions copyright which is 100% held by NumFOCUS. Should this mention the contributors section on the readme?

Lincense: https://github.com/numfocus/DISCOVER-Cookbook/blob/main/LICENSE
Contributors section: https://github.com/numfocus/DISCOVER-Cookbook/tree/main?tab=readme-ov-file#contributors-


---

## 🔄 The Procedure – Roll-in Basis

We are onboarding translators on a rolling basis. Once accepted, you’ll be added to the platforms and can begin contributing right away.

- **Acceptance Process:** TBA
- **Instructions for Contributors:** TBA

---
Loading