テクニカルライティング

ドキュメントの文章校正には、textlintが便利

こんにちは! 開発部 テクニカルコミュニケーションチーム(TCチーム)の原嶋です。 TCチームではユーザーサポートコンテンツ(ヘルプやリリースノートなど)を作成しているんですが、担当する文書はどれも会社の公式文書なので、校正でのチェック項目がたく…

ヘルプサイトについて語るMeetupやりました

こんにちは!開発部テクニカルコミュニケーションチームの仲田です。 すっかり梅雨ですね。皆さんMeetupしてますか?(梅雨関係ない) うちのチームは初めてやりました。今回はその開催報告です。 参加者20人で開催予定でしたが、募集してみると、ありがたい…

ドキュメントサイトの管理にはNetlify+静的サイトジェネレーターが便利

こんにちは!開発部テクニカルコミュニケーショングループの仲田(@naoh_nak)です。 最近WeWorkみなとみらいに出没し始めました。おしゃれ過ぎて少し落ち着かないのですが、慣れたら自分もそちら側の人間だと思うようになるのかもしれません。 前回はヘルプ…

プロダクトのヘルプサイトをマークダウンに移行した話

こんにちは!開発部テクニカルコミュニケーショングループの仲田です。 皆さんマークダウン使ってますか?(唐突) 文書記法の一つで、プログラマーにとっては馴染みがあるものだと思います。サイボウズのプロダクト仕様書もマークダウンで書かれることが多…