【technical writer】技術的なことがらについて、マニュアル・チュートリアル・解説記事などを専門に書く人。
aptpod Advent Calendar 2024 の12月9日の記事です。 本日は、テクニカルライターの篠崎が担当します。 当社では今年、ドキュメントサイトをリニューアルし、複数のプロダクトのドキュメントを1つのウェブサイトに統合しました。 これにより、読み手は全体を俯瞰しながら各製品の詳細に読み進めることができるようになりました。 また、私のような制作側にとっては、ページ間のリンクを張りやすくなりました。内容の重複も減らすことができ、更新作業もしやすくなりました。 統合されたドキュメントサイト 製品ドキュメントの作成にはSphinxを使っています。これまでプロダクトごとに別々だったSp…
こんにちは。サイボウズでテクニカルライターをしている小林（@kbys_psb）です。このブログは、テクニカルライター/ローカライズ リレーブログの7本目の記事です。 みなさんは文章を書くときに、考えることや気にすることが多くて、執筆や推敲に時間がかかってしまった経験はありますか？また、ほかの人が書いた文章をレビューするときに、何をどこまでチェックしたらよいか判断に迷ったことはありますか？ そんな自分たちの経験から、ヘルプ制作に必要なライティングの観点を洗い出して、まとめることにしました。 どういうものを作るか チェックリストではなく、ヘルプ制作に必要なライティングの観点をまとめる 執筆時の指針…
こんにちは。テクニカルライターチームのueです。サイボウズでkintoneの画面のUI用語やヘルプの作成を担当しています。 このブログは、テクニカルライター/ローカライズ リレーブログの6本目の記事です。 今回は、kintoneライターチームがチーム作りの一環として、チームビルディングを実施した様子をご紹介します。 チームビルディングの目的 私たち、kintoneライターチームは、現在8名で構成されていますが、昨年から今年にかけてメンバーが大きく変わりました。私自身も今年キャリア入社でチームにジョインしています。 そこで、私たちは、kintoneライターチームとしてもう一歩お互いの理解を深め、…
こんにちは、テクニカルライターチームのAhiuru-kunです。このブログは、テクニカルライター/ローカライズ リレーブログの4本目の記事です。 今回は、元々経理だった自分がテクニカルライターにキャリアチェンジした経緯と、その後感じたことをお話しします。 これまでの経歴 経理職として計9年ほど働いてきました。サイボウズには5年ほど前に中途入社しました。 経理業務は、（ざっくり書くと）会社全体から数字を集めて、見やすくして、報告するのが仕事です。そんな業務をする中で、もっと自分が興味のある、好きなプロダクトやサービスに貢献したいと思うようになりました。 サイボウズへの転職を決心した理由も、サイボ…
こんにちは。テクニカルライターチームのpiyo（@_chick_p）です。 このブログは、テクニカルライター/ローカライズ リレーブログの3本目の記事（後編）です。 前編の記事では、多言語展開のために製品の画面文言を改善した話を紹介しました。 スペイン語対応でわかった、語順が変わる問題に取り組んだ話 - Cybozu Inside Out | サイボウズエンジニアのブログ 後編では、ヘルプサイトに機械翻訳のサービスを導入する際にわかった、機械翻訳でのハマりどころとその解決策を紹介します。 機械翻訳のハマりどころ ヘルプサイトでは、元々の4言語に加え、スペイン語のコンテンツも提供しています。 ス…
このブログは、テクニカルライター/ローカライズ リレーブログの2本目の記事になります。 こんにちは、テクニカルライターチーム近藤です。普段はテクニカルイラストレーター兼ライターとして働いており、担当製品はGaroonです。 Garoonのテクニカルライターチーム（以下、Garoon TCと呼びます）には、テクニカルライターやローカライズ担当者が所属しており、Garoonのヘルプの執筆や翻訳、画面文言の作成などを行っています。 今日は、そんなGaroon TCが初めて「チームの目標」を設定したお話をしたいと思います。 目標設定は難しい テクニカルライターやローカライズチームが目標を立てるのは、と…
このブログは、テクニカルライター/ローカライズ リレーブログの1本目の記事です。 こんにちは！サイボウズでテクニカルライターをしている小林（@kbys_psb）です。 最近、テクニカルライターが社内にいる会社が増えてきたのを感じています。 ただ、一口に「テクニカルライター」といっても、会社によって、仕事の内容や働いている環境は様々です。 今回は、サイボウズのテクニカルライターがどんな組織の中で仕事しているのか、どんな仕事の面白さがあるか、どんな人が活躍しているのか、などを紹介します。 「サイボウズのテクニカルライター」が所属している組織 テクニカルライターやローカライズを担当するメンバーは、こ…
こんにちは！サイボウズでテクニカルライターをしている小林（@kbys_psb）です。 今回、サイボウズのテクニカルライターやローカライズ担当のメンバーでリレーブログをはじめることにしました。 リレーブログでは、私たちがどのような業務に取り組み、どのような課題に対してどう解決していったかを紹介していきます。 テクニカルライターやローカライズの仕事に興味がある方、現在同じような業務をされている方、これからチームに同様の役割を導入しようと考えている方にとって、参考になる情報や共感できるエピソードをお届けできればと思っています。 この企画を通じて、サイボウズのテクニカルライターやローカライズ担当の仕事…
本記事は、ICDS noteへ移行しました。 note.com
長い期間テクニカルライティングの仕事をして感じたことです。できるライターほど基本を大事にし、いつまでも繰り返し学んでいます。できないライターは逆です。 ある団体が実施している検定試験、ライティング検定3級というものがあります。それに合格しているのに正しく書けないライターが多くて驚きます。 不思議だと思いませんか？「本当に合格しているの？」と聞くと「はい」と答えます。短く書く、誤解のない文章を書く技術、安全に関する最低限の知識など、マニュアルを書くために基本ですが、これで必要十分な内容です。問題は、いつもそれを使えるかどうかです！（なぜできない？） 気づきました。事前に勉強するテキストの内容と試…
maclalala2.wordpress.com
