ソフトウェアエンジニアが書く、英語と日本語のAPIドキュメントと開発者ガイド。

ドキュメントプロジェクトの費用はどのくらいですか？

すべてのプロジェクトで、作業開始前に書面で固定料金をご提示します。代表的な出発点：

• ドキュメントのレビュー・編集：5,000語まで900ドルから、通常1〜2週間
• 新規ドキュメント制作：5,000語のプロジェクトで5,500ドルから。大規模なドキュメントセットは、製品の規模によっては数か月かかることもあります

2,500ドルのドキュメント診断は、正確なお見積りを作るための手段でもあります。何が存在し、何が欠けていて、修正にどれだけの作業が必要かが正確に分かります。

ドキュメント診断の費用はいくらですか？

英語・日本語合わせて25,000語までのドキュメントを、2,500ドルの固定料金で診断します。それを超える場合は追加1,000語ごとに100ドルです（例：40,000語なら4,000ドル）。ドキュメントが非常に大規模な場合は、代表的な25,000語のサンプルを選んで基本料金で診断することもできます。ドキュメントの問題はドキュメント全体で繰り返し現れる傾向があるため、適切に選んだサンプルからパターンが見え、修正計画は全体に適用できます。さらに、60日以内に修正作業をご依頼いただいた場合は2,500ドル全額をプロジェクト費用に充当するため、診断は実質無料になります。

期間はどのくらいかかりますか？

診断は25,000語までなら通常1週間以内にお届けします。それ以上の規模は分量に応じて調整し、お申し込み時に日程を確定します。レビュー・編集プロジェクトは通常1〜2週間。ゼロからの新規ドキュメント制作は、範囲とレビューの速度によっては数か月かかることが多いです。書面のスコープにはスケジュールが含まれます。

NDAを締結してもらえますか？

はい。機密情報を共有いただく前に、まず当社の相互NDAをお送りします。御社指定のNDAが必要な場合は、そちらのレビューにも喜んで対応します。上記の大手企業向けの仕事をすべて含め、過去の仕事の多くはNDAのもとで行われました。ポートフォリオに掲載していないのはそのためです。

日本語は誰が書きますか？

日本語の文書はすべて、ソフトウェアエンジニアとしての経験も持つネイティブスピーカー、ヒロミ・デヤングが執筆またはレビューします。英語のテキストだけでなく、製品そのものとエンジニアの方々の回答をもとに書くため、日本語はシステムの実際の挙動を正しく伝えます。その他の言語については、審査済みのネイティブテクニカルライターと連携します。

国際化（i18n）も支援してもらえますか？

はい。ハードコードされた文字列、日付・数値フォーマット、テキストの伸長、用語といった国際化の問題がないか製品とドキュメントをレビューし、チームが効率よくローカライズするためのガイドラインを執筆します。

どのようなツールやフォーマットに対応していますか？

私たちはdocs-as-codeを推奨しています。ドキュメントをGitで管理し、プレーンテキストで書き、コードと同じようにプルリクエストでレビューする方法です。普段使うスタックはMarkdown + ZolaとAsciiDoc + Antoraです（Antoraポートフォリオセット）。既存の環境での作業にも同じように対応できます。Gitとプルリクエスト、OpenAPI/Swagger仕様、多くのチームが使っているMarkdownベースのツールなどです。それ以外のツールをお使いの場合はお気軽にお尋ねください。対応できるかどうか正直にお答えします。

クリントンは2026年10月に「Sogo Docs」もローンチ予定です。GitとMarkdownの上に築かれたドキュメントプラットフォームで、Gitブランチごとに別バージョンのドキュメントを公開できます。Antoraに似ていますが、セットアップははるかに簡単です。

OpenAPI仕様や既存のドキュメントをもとに作業できますか？

はい。OpenAPI仕様はAPIリファレンスの出発点として優れていますが、それだけではドキュメント全体にはなりません。開発者には、実際のタスクをどう達成するかを説明するガイドも必要です。お手元にあるものを土台に作り上げます。

拠点はどこですか？対応時間は？

拠点は米国マウンテンタイムゾーンで、英語と日本語で世界中のお客様と仕事をしています。米国のお客様には米国の通常営業時間に対応します。日本のお客様には日本時間の午前9時から午後3時まで、つまり業務時間内に対応するため、翌日を待たずに打ち合わせや質問への回答が得られます。

御社が適任でなかった場合はどうなりますか？

正直にそうお伝えします。可能であれば、適任の方をご紹介します。