# PyDoc-ZHTW sciwork seminar summer 2024

## What is sciwork seminar

> sciwork seminar is a one-day event to include technical talks, tutorials, and coding activities.

6/22 會有一整天的議程+半天的衝刺開發活動。
我們專案需要做：
+ Talk Session: 分享 30 mins 的內容
+ Code Session: 帶 meetup 的概念，推廣專案

## 參加人員

+ Matt (確定去不了惹QQ)
+ Leon
+ Joyce
+ 小智
+ Timmy

## Topic and Abstract

**Translating Python Documentation: Bridging Languages and Communities**

1. Document Collaboration and Culture: What do we do in Python Documentation Translation
2. Python Doc Translation: Behind the Scene

謝謝 Copilot:
+ Translating Python Documentation: Bridging Languages and Communities
+ The Art of Technical Translation: Python Documentation in Traditional Chinese
+ ~~Volunteer Power: Organizing Technical Translation Teams for Python~~
+ ~~From English to Traditional Chinese: The Journey of Python Docs~~
+ ~~Coding in Our Own Words: Localizing Python for Taiwan~~

## 目標

讓大家認識我們，也可以讓寫程式的人嘗試接觸

## 主題發想

1. 專案發展歷程：講述專案目標、過往歷史、當前目標
2. 探討繁體中文專有名詞的必要性：部分開發者認為沒有這個必要(PTT 的部分網友覺得)，但為甚麼我們想要推廣這種文化?
3. 技術文件翻譯志工組織的運作模式
- 相較於其他類型技術社群的運作差異：
- 可能已經參加過社群的人：如果你知道 PyCon，他們的運作目標會跟我們不一樣
- 或是一張白紙：
- 招募、運行、合作等面向所遭遇的困難
- 招募：Overlap with 運行
- 運行：花時間、精力在翻譯的人比較少
- 合作：Code Review，需要跟貢獻者來回內容；反例，中國翻譯團隊有翻譯就直接 Merge
- 台灣的技術文件繁化環境與趨勢（可能得做些 survey）
- 技術文件繁化的組織有誰？
- 資源共享但沒有人可以組織完成這件事情
- Hexojs (主力已不是繁中使用者),
- Starship (有翻譯就 Merge),
- MDN, Firefox, M$ (可能有組織維護?)
- 與 Python core 合作關係
- Sync with CPython
- Collab with other 語系
- 土耳其文嘗試合作 Chat-GPT 翻譯，但未果，缺 Leader
- 貢獻 Python 最簡單的方式就是翻譯
- 宣布獎品大法(??)
- 如何定義可得獎?
- 獎品從何來?
4. Python Doc: Behind the Scene
- 嘗試回答：一般我們見到的繁中文件頁面是如何產生？
- 原文 rst -> sync -> 翻譯 po -> doc build -> html
- 嘗試回答：發現文件有誤該怎麼辦？
- 回報錯誤方式
- 自己修：build tool 介紹 + live demo
- cons: 容易恍神就跟不上、could be too technical、比較難吸引對翻譯沒興趣的人