Merge pull request #38 from domaframework/remove-crowdin

Remove Crowdin integration and add comprehensive translation guide

Author: nakamura-to

CLAUDE.md

@@ -7,7 +7,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 This is the documentation repository for Doma, a database access framework for Java. The documentation is built using Sphinx and hosted on ReadTheDocs. The repository manages:
 
 - English documentation (primary)
-- Japanese translation via Crowdin integration
+- Japanese translation
 - Multiple output formats (HTML, PDF, ePub)
 
 ## Development Commands
@@ -41,12 +41,6 @@ make
 cd docs
 # Generate POT files for translation
 sphinx-build -b gettext . _build/gettext
-
-# Upload to Crowdin (admin only)
-crowdin push
-
-# Download translations (admin only)  
-crowdin pull
 ```
 
 ## Architecture
@@ -74,8 +68,7 @@ These variables can be used in documentation via Jinja templating.
 
 ### Translation Workflow
 - English content is written in .rst files
-- Crowdin integration automatically generates .pot files for translators
-- Japanese translations are managed via Crowdin project: https://crowdin.com/project/doma-docs
+- POT files for translation are generated using `sphinx-build -b gettext`
 - Translated .po files are stored in `/docs/locale/ja/LC_MESSAGES/`
 
 ## Content Guidelines

CONTRIBUTING.md

@@ -55,21 +55,3 @@ Execute the `sphinx-build` command in the docs directory:
 ```
 $ sphinx-build -b gettext . _build/gettext
 ```
-
-#### Upload POT files to Crowdin
-
-Execute the `crowdin` command in the docs directory:
-
-```
-$ crowdin push
-```
-
-This command is only permitted for administrators.
-
-#### Download PO files from Crowdin
-
-Execute the `crowdin` command in the docs directory:
-
-```
-$ crowdin pull
-```

README.md

@@ -1,12 +1,11 @@
 # Doma Documentation
 
 This repository manages the English version of the [Doma](https://github.com/domaframework/doma) documentation.
-Localization into Japanese is managed through [the Crowdin project](https://crowdin.com/project/doma-docs).
+Localization into Japanese is managed manually.
 
 We welcome contributions to improve both the English and Japanese versions.
 
 [![docs](https://readthedocs.org/projects/doma/badge/?version=latest)](https://doma.readthedocs.io/en/latest/)
-[![Crowdin](https://badges.crowdin.net/doma-docs/localized.svg)](https://crowdin.com/project/doma-docs)
 
 ## Deployment site
 
@@ -19,10 +18,35 @@ Please read the [CONTRIBUTING.md](CONTRIBUTING.md) file.
 
 ## To Those Who Can Help with Japanese Translation
 
-日本語翻訳に協力してくれる方は、[Crowdin](https://crowdin.com/project/doma-docs) に登録して翻訳をお願いします。
+日本語翻訳に協力してくれる方は、[Issues](https://github.com/domaframework/doma-docs/issues) または [Discussions](https://github.com/domaframework/doma-docs/discussions) でお気軽にお声がけください。
 英語から日本語への翻訳はもちろん、既存の日本語訳の修正や改善も歓迎します。
 
-Crowdinの使い方や翻訳方針に関する質問は [Issues](https://github.com/domaframework/doma-docs/issues) または [Discussions](https://github.com/domaframework/doma-docs/discussions) でお気軽にどうぞ。
+### 翻訳の手順
+
+1. **新しい翻訳を追加する場合:**
+   - `docs` ディレクトリで `sphinx-build -b gettext . _build/gettext` を実行してPOTファイルを生成
+   - `docs/locale/ja/LC_MESSAGES/` 内の対応する `.po` ファイルを編集
+   - `msgid` の英語テキストに対応する `msgstr` に日本語翻訳を記入
+
+2. **既存の翻訳を修正する場合:**
+   - `docs/locale/ja/LC_MESSAGES/` 内の該当する `.po` ファイルを直接編集
+   - 修正したい `msgstr` の内容を変更
+
+3. **ファイル構成:**
+   - メインページ: `docs/locale/ja/LC_MESSAGES/index.po`
+   - 各セクション: `docs/locale/ja/LC_MESSAGES/{セクション名}.po`
+   - クエリ関連: `docs/locale/ja/LC_MESSAGES/query/{ファイル名}.po`
+
+4. **翻訳例:**
+   ```
+   msgid "Getting Started"
+   msgstr "はじめに"
+   ```
+
+5. **AIツールを活用した翻訳:**
+   - [Claude Code](https://claude.ai/code)、[Gemini CLI](https://github.com/google-gemini/gemini-cli) などのコーディングエージェントツールを使って効率的に翻訳できます
+   - 例: 「このPOファイルの未翻訳部分を日本語に翻訳してください」と依頼
+   - 大量の翻訳作業や一貫性のチェックに特に有効です
 
 日本語翻訳に関する問い合わせは日本語で登録いただいて構いません。