SlideShare a Scribd company logo
1 of 98
Download to read offline
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
人と技術を繋げる
「技術文書」について
mochikoAsTech
2021.11.27
オープンセミナー2021@岡山
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
16:15~17:05
50分間
#OSO2021
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
自己紹介
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
はじめまして
mochikoAsTechです
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
mochikoAsTech
プログラマ(3年)
広報(4年)
インフラエンジニア(7年)
現在はLINEでテクニカルライター
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
今日話すこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
このセッションのタイトル
人と技術を繋げる
「技術文書」について
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
オープンセミナー2021@岡山のテーマ
extend engineering
~人と技術を繋げよう~
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
このセッションのタイトル
人と技術を繋げる
「技術文書」について
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
早速ですが
みなさんに質問です
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
みなさんが
新しい技術をはじめるとき
先ずは何をしますか?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
新しい技術をはじめるとき先ずは何をするか?
・取りあえず触ってみる
・身近な詳しい人に教えてもらう
・本や雑誌を読む
・manコマンドをたたいてマニュアルを読む
・公式のリファレンスやドキュメントを読む
・Qiita、Zenn、ブログなどの技術記事を読む
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
新しい技術をはじめるとき先ずは何をするか?
・取りあえず触ってみる
・身近な詳しい人に教えてもらう
・本や雑誌を読む
・manコマンドをたたいてマニュアルを読む
・公式のリファレンスやドキュメントを読む
・Qiita、Zenn、ブログなどの技術記事を読む
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
新しい技術をはじめよう
と思ったとき
私たちと技術の間には
たくさんの技術文書がある
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
技術書を書いたことがきっかけで
「技術文書」を書く
テクニカルライターになった
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
今日話すこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1つめの話
技術書を書いたことで
テクニカルライターになった話
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
2つめの話
技術文書を
「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1. 技術書を書いたことで
テクニカルライターになった話
2. 技術文書を「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1.技術書を書いたことで
テクニカルライターになった話
2. 技術文書を「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
ぎじゅつしょてん
技術書典
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
好きな技術への
あふれ出る気持ちを
本にしたためて
販売できるイベント
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
https://techbookfest.org/market/
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
https://twitter.com/techbookfest
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
技術書典で
初めて同人誌を
作って出した
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
なんでDNSの本を
書いたのか
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
DNSが好きだから!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
初心者向けのDNSの本は
需要があると思っていたから
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
IT系で開発をやってるけど
インフラ周りは
あんまり分かってないのが
ちょっとコンプレックス・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
DNSのこと
正直よく分からないまま
ドメイン名を買ったり
レコード設定したりしてる
これでいいのかな・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
DNSとかインフラとか
もっとちゃんと
分かるようになりたい!
と思ってる開発系のエンジニア
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
そういう人の
役に立てたらいいな
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
同人誌は印刷所に
原稿のPDFとか
表紙のイラレとかを
入稿して印刷をお願いする
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
最初は
40部刷ろうと
思っていた
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
正直40部でも
売れるか心配・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
なんやかんやあって
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
結局400部刷った
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
「準備に総額いくらかけたの?」
「あー・・・うん・・・」
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
迎えた技術書典の当日
「DNSをはじめよう」は
売れたのか?爆死したのか?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
開場したとき 2時間後
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
みんな
「こいつ死ぬな」
と思ってた
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
書いた本人が
いちばん驚いてた
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
優しい先輩が
隣で丁寧に教えて
くれてるみたい
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
インフラを
すごく簡単なところから
丁寧に教える本って
需要があるのでは?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
もともと本を書く
ノウハウが
あったわけじゃない
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
こう書いたら分かりやすい?
この順番の方が理解しやすい?
というように
読む人のことを考えて書いた
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
個人事業主になる
=副業扱い
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
会社の資本が変わり
執筆の副業が歓迎されない
雰囲気に・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
よし、転職だ!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
きみきみ、一緒に
テクニカルライター
してみないかね?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
話を聞くまで知らなかったこと
1. テクニカルライターという職種があること
2. LINEにはテクニカルライティング専門の
チームがあること
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
ドキュメントを書く専門職
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
LINEのテクニカルライターは、主に
社外の開発者向けに
技術ドキュメントを書いて提供する
という仕事をしている
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
https://linedevday.linecorp.com/2021/ja/sessions/148
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
ドキュメントを書く専門職
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
え、毎日ドキュメント書いて
給料もらえて感謝される?
夢のようなお仕事では?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
新しい技術をはじめよう
と思ったとき
私たちと技術の間には
たくさんの技術文書がある
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
技術文書を書くのは
選ばれた特別な人だけが
できることではなく
自分にもできること
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
自分はまだ
全然詳しくないから
もっと詳しくなってから
書こう・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
書いてみることで
自分がまだちゃんと
分かっていなかった部分に
気づける
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
技術文書を書くと
いつか誰かの役に立つ
(かもしれない)し
自分の学びにもなる
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
誰でもやってみればできること
の先に「本を書く」とか
「テクニカルライターになる」
という出来事もある
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1.技術書を書いたことで
テクニカルライターになった話
2. 技術文書を「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1. 技術書を書いたことで
テクニカルライターになった話
2.技術文書を「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
技術文書を
書いている人から
よく聞かれる質問
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
もっとうまく書けるように
なりたいです!
どんなことに気をつけて書いたら
文章力が上がりますか?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
いっぱい読んで
いっぱい書くといいよ!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
参考にしたいお手本のような表現
使わない方がいいと感じる表現
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
少ないパーツで
「なんか作れ」って
言われるとしんどい
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
「この言い回し」
「こういう表現」
「こういう説明の仕方」
「こういう構成」
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
いいパーツが
自分の中にいっぱいあると
「いい文章」が
組み立てやすくなる
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
いっぱい読んで
いっぱい書くといいよ!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
実際書いてみると
思っていたより全然うまく書けなくて
すごく苦しい・・・
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
でも書き上げることが大切!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
書き上げたものは
今後、改善点を見つけて
よりよい文章にしていくための土台
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
完璧なものだけを世に出そう!
(と思っていつまでも出せない)
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
いっぱい読んで
いっぱい書くといいよ!
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
文章力をあげるために
おすすめの本とか
ありますか?
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
日本語スタイルガイド(第3版)
一般財団法人テクニカルコミュニケーター協会 / テクニカルコミュニケーター協会出版事業部
https://www.amazon.co.jp/dp/4902820102
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
数学文章作法 基礎編・推敲編
結城 浩 / 筑摩書房
https://www.amazon.co.jp/dp/448009525X
https://www.amazon.co.jp/dp/4480095268
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
【新版】日本語の作文技術
本多勝一 / 朝日新聞出版
https://www.amazon.co.jp/dp/4022618450
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
https://www.youtube.com/playlist?list=PL80ip6bOwQsIfO757li02S42XDdWdnmED
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
会社によって呼び方は
テクニカルライターだったり
UXライターだったり
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
ちょっと
伸び悩む時期が
やってくる
https://www.youtube.com/playlist?list=PL80ip6bOwQsIfO757li02S42XDdWdnmED
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
1. 技術書を書いたことで
テクニカルライターになった話
2.技術文書を「書く人」になったときに
知っておくとよいこと
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
さいごに
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
https://linecorp.com/ja/career/position/806
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
会議用個室は
Discord繋ぎながら
Among Usするとき
すごくいい
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
引用元:https://linecorp.com/ja/pr/news/ja/2021/3912
***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
人と技術を繋げる
「技術文書」について
mochikoAsTech
2021.11.27
オープンセミナー2021@岡山

More Related Content

Recently uploaded

TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案
TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案
TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案sugiuralab
 
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineerYuki Kikuchi
 
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdf
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdfクラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdf
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdfFumieNakayama
 
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)UEHARA, Tetsutaro
 
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)Hiroki Ichikura
 
SOPを理解する 2024/04/19 の勉強会で発表されたものです
SOPを理解する       2024/04/19 の勉強会で発表されたものですSOPを理解する       2024/04/19 の勉強会で発表されたものです
SOPを理解する 2024/04/19 の勉強会で発表されたものですiPride Co., Ltd.
 
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdf
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdfAWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdf
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdfFumieNakayama
 
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?akihisamiyanaga1
 
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察 ~Text-to-MusicとText-To-ImageかつImage-to-Music...
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察  ~Text-to-MusicとText-To-ImageかつImage-to-Music...モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察  ~Text-to-MusicとText-To-ImageかつImage-to-Music...
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察 ~Text-to-MusicとText-To-ImageかつImage-to-Music...博三 太田
 

Recently uploaded (9)

TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案
TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案
TataPixel: 畳の異方性を利用した切り替え可能なディスプレイの提案
 
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer
自分史上一番早い2024振り返り〜コロナ後、仕事は通常ペースに戻ったか〜 by IoT fullstack engineer
 
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdf
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdfクラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdf
クラウドネイティブなサーバー仮想化基盤 - OpenShift Virtualization.pdf
 
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)
デジタル・フォレンジックの最新動向(2024年4月27日情洛会総会特別講演スライド)
 
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)
【早稲田AI研究会 講義資料】3DスキャンとTextTo3Dのツールを知ろう!(Vol.1)
 
SOPを理解する 2024/04/19 の勉強会で発表されたものです
SOPを理解する       2024/04/19 の勉強会で発表されたものですSOPを理解する       2024/04/19 の勉強会で発表されたものです
SOPを理解する 2024/04/19 の勉強会で発表されたものです
 
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdf
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdfAWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdf
AWS の OpenShift サービス (ROSA) を使った OpenShift Virtualizationの始め方.pdf
 
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?
CTO, VPoE, テックリードなどリーダーポジションに登用したくなるのはどんな人材か?
 
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察 ~Text-to-MusicとText-To-ImageかつImage-to-Music...
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察  ~Text-to-MusicとText-To-ImageかつImage-to-Music...モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察  ~Text-to-MusicとText-To-ImageかつImage-to-Music...
モーダル間の変換後の一致性とジャンル表を用いた解釈可能性の考察 ~Text-to-MusicとText-To-ImageかつImage-to-Music...
 

Featured

2024 State of Marketing Report – by Hubspot
2024 State of Marketing Report – by Hubspot2024 State of Marketing Report – by Hubspot
2024 State of Marketing Report – by HubspotMarius Sescu
 
Everything You Need To Know About ChatGPT
Everything You Need To Know About ChatGPTEverything You Need To Know About ChatGPT
Everything You Need To Know About ChatGPTExpeed Software
 
Product Design Trends in 2024 | Teenage Engineerings
Product Design Trends in 2024 | Teenage EngineeringsProduct Design Trends in 2024 | Teenage Engineerings
Product Design Trends in 2024 | Teenage EngineeringsPixeldarts
 
How Race, Age and Gender Shape Attitudes Towards Mental Health
How Race, Age and Gender Shape Attitudes Towards Mental HealthHow Race, Age and Gender Shape Attitudes Towards Mental Health
How Race, Age and Gender Shape Attitudes Towards Mental HealthThinkNow
 
AI Trends in Creative Operations 2024 by Artwork Flow.pdf
AI Trends in Creative Operations 2024 by Artwork Flow.pdfAI Trends in Creative Operations 2024 by Artwork Flow.pdf
AI Trends in Creative Operations 2024 by Artwork Flow.pdfmarketingartwork
 
PEPSICO Presentation to CAGNY Conference Feb 2024
PEPSICO Presentation to CAGNY Conference Feb 2024PEPSICO Presentation to CAGNY Conference Feb 2024
PEPSICO Presentation to CAGNY Conference Feb 2024Neil Kimberley
 
Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)contently
 
How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024Albert Qian
 
Social Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsSocial Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsKurio // The Social Media Age(ncy)
 
Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Search Engine Journal
 
5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summarySpeakerHub
 
ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd Clark Boyd
 
Getting into the tech field. what next
Getting into the tech field. what next Getting into the tech field. what next
Getting into the tech field. what next Tessa Mero
 
Google's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentGoogle's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentLily Ray
 
Time Management & Productivity - Best Practices
Time Management & Productivity -  Best PracticesTime Management & Productivity -  Best Practices
Time Management & Productivity - Best PracticesVit Horky
 
The six step guide to practical project management
The six step guide to practical project managementThe six step guide to practical project management
The six step guide to practical project managementMindGenius
 
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...RachelPearson36
 

Featured (20)

2024 State of Marketing Report – by Hubspot
2024 State of Marketing Report – by Hubspot2024 State of Marketing Report – by Hubspot
2024 State of Marketing Report – by Hubspot
 
Everything You Need To Know About ChatGPT
Everything You Need To Know About ChatGPTEverything You Need To Know About ChatGPT
Everything You Need To Know About ChatGPT
 
Product Design Trends in 2024 | Teenage Engineerings
Product Design Trends in 2024 | Teenage EngineeringsProduct Design Trends in 2024 | Teenage Engineerings
Product Design Trends in 2024 | Teenage Engineerings
 
How Race, Age and Gender Shape Attitudes Towards Mental Health
How Race, Age and Gender Shape Attitudes Towards Mental HealthHow Race, Age and Gender Shape Attitudes Towards Mental Health
How Race, Age and Gender Shape Attitudes Towards Mental Health
 
AI Trends in Creative Operations 2024 by Artwork Flow.pdf
AI Trends in Creative Operations 2024 by Artwork Flow.pdfAI Trends in Creative Operations 2024 by Artwork Flow.pdf
AI Trends in Creative Operations 2024 by Artwork Flow.pdf
 
Skeleton Culture Code
Skeleton Culture CodeSkeleton Culture Code
Skeleton Culture Code
 
PEPSICO Presentation to CAGNY Conference Feb 2024
PEPSICO Presentation to CAGNY Conference Feb 2024PEPSICO Presentation to CAGNY Conference Feb 2024
PEPSICO Presentation to CAGNY Conference Feb 2024
 
Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)Content Methodology: A Best Practices Report (Webinar)
Content Methodology: A Best Practices Report (Webinar)
 
How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024How to Prepare For a Successful Job Search for 2024
How to Prepare For a Successful Job Search for 2024
 
Social Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie InsightsSocial Media Marketing Trends 2024 // The Global Indie Insights
Social Media Marketing Trends 2024 // The Global Indie Insights
 
Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024Trends In Paid Search: Navigating The Digital Landscape In 2024
Trends In Paid Search: Navigating The Digital Landscape In 2024
 
5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary5 Public speaking tips from TED - Visualized summary
5 Public speaking tips from TED - Visualized summary
 
ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd ChatGPT and the Future of Work - Clark Boyd
ChatGPT and the Future of Work - Clark Boyd
 
Getting into the tech field. what next
Getting into the tech field. what next Getting into the tech field. what next
Getting into the tech field. what next
 
Google's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search IntentGoogle's Just Not That Into You: Understanding Core Updates & Search Intent
Google's Just Not That Into You: Understanding Core Updates & Search Intent
 
How to have difficult conversations
How to have difficult conversations How to have difficult conversations
How to have difficult conversations
 
Introduction to Data Science
Introduction to Data ScienceIntroduction to Data Science
Introduction to Data Science
 
Time Management & Productivity - Best Practices
Time Management & Productivity -  Best PracticesTime Management & Productivity -  Best Practices
Time Management & Productivity - Best Practices
 
The six step guide to practical project management
The six step guide to practical project managementThe six step guide to practical project management
The six step guide to practical project management
 
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
Beginners Guide to TikTok for Search - Rachel Pearson - We are Tilt __ Bright...
 

About technical docs that connect people and technology

  • 1. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 人と技術を繋げる 「技術文書」について mochikoAsTech 2021.11.27 オープンセミナー2021@岡山
  • 2. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 16:15~17:05 50分間 #OSO2021
  • 3. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 自己紹介
  • 4. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** はじめまして mochikoAsTechです
  • 5. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** mochikoAsTech プログラマ(3年) 広報(4年) インフラエンジニア(7年) 現在はLINEでテクニカルライター
  • 6. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 今日話すこと
  • 7. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** このセッションのタイトル 人と技術を繋げる 「技術文書」について
  • 8. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** オープンセミナー2021@岡山のテーマ extend engineering ~人と技術を繋げよう~
  • 9. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** このセッションのタイトル 人と技術を繋げる 「技術文書」について
  • 10. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 早速ですが みなさんに質問です
  • 11. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** みなさんが 新しい技術をはじめるとき 先ずは何をしますか?
  • 12. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 新しい技術をはじめるとき先ずは何をするか? ・取りあえず触ってみる ・身近な詳しい人に教えてもらう ・本や雑誌を読む ・manコマンドをたたいてマニュアルを読む ・公式のリファレンスやドキュメントを読む ・Qiita、Zenn、ブログなどの技術記事を読む
  • 13. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 新しい技術をはじめるとき先ずは何をするか? ・取りあえず触ってみる ・身近な詳しい人に教えてもらう ・本や雑誌を読む ・manコマンドをたたいてマニュアルを読む ・公式のリファレンスやドキュメントを読む ・Qiita、Zenn、ブログなどの技術記事を読む
  • 14. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 新しい技術をはじめよう と思ったとき 私たちと技術の間には たくさんの技術文書がある
  • 15. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 技術書を書いたことがきっかけで 「技術文書」を書く テクニカルライターになった
  • 16. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 今日話すこと
  • 17. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1つめの話 技術書を書いたことで テクニカルライターになった話
  • 18. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 2つめの話 技術文書を 「書く人」になったときに 知っておくとよいこと
  • 19. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1. 技術書を書いたことで テクニカルライターになった話 2. 技術文書を「書く人」になったときに 知っておくとよいこと
  • 20. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1.技術書を書いたことで テクニカルライターになった話 2. 技術文書を「書く人」になったときに 知っておくとよいこと
  • 21. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** ぎじゅつしょてん 技術書典
  • 22. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 好きな技術への あふれ出る気持ちを 本にしたためて 販売できるイベント
  • 23. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 24. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** https://techbookfest.org/market/
  • 25. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** https://twitter.com/techbookfest
  • 26. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 技術書典で 初めて同人誌を 作って出した
  • 27. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 28. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** なんでDNSの本を 書いたのか
  • 29. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** DNSが好きだから!
  • 30. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 初心者向けのDNSの本は 需要があると思っていたから
  • 31. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** IT系で開発をやってるけど インフラ周りは あんまり分かってないのが ちょっとコンプレックス・・・
  • 32. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** DNSのこと 正直よく分からないまま ドメイン名を買ったり レコード設定したりしてる これでいいのかな・・・
  • 33. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** DNSとかインフラとか もっとちゃんと 分かるようになりたい! と思ってる開発系のエンジニア
  • 34. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** そういう人の 役に立てたらいいな
  • 35. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 36. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 同人誌は印刷所に 原稿のPDFとか 表紙のイラレとかを 入稿して印刷をお願いする
  • 37. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 最初は 40部刷ろうと 思っていた
  • 38. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 正直40部でも 売れるか心配・・・
  • 39. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** なんやかんやあって
  • 40. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 結局400部刷った
  • 41. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 「準備に総額いくらかけたの?」 「あー・・・うん・・・」
  • 42. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 迎えた技術書典の当日 「DNSをはじめよう」は 売れたのか?爆死したのか?
  • 43. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 開場したとき 2時間後
  • 44. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** みんな 「こいつ死ぬな」 と思ってた
  • 45. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 書いた本人が いちばん驚いてた
  • 46. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 優しい先輩が 隣で丁寧に教えて くれてるみたい
  • 47. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** インフラを すごく簡単なところから 丁寧に教える本って 需要があるのでは?
  • 48. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 49. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 50. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** もともと本を書く ノウハウが あったわけじゃない
  • 51. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** こう書いたら分かりやすい? この順番の方が理解しやすい? というように 読む人のことを考えて書いた
  • 52. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 個人事業主になる =副業扱い
  • 53. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 会社の資本が変わり 執筆の副業が歓迎されない 雰囲気に・・・
  • 54. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** よし、転職だ!
  • 55. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 56. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** きみきみ、一緒に テクニカルライター してみないかね?
  • 57. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 話を聞くまで知らなかったこと 1. テクニカルライターという職種があること 2. LINEにはテクニカルライティング専門の チームがあること
  • 58. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** ドキュメントを書く専門職
  • 59. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** LINEのテクニカルライターは、主に 社外の開発者向けに 技術ドキュメントを書いて提供する という仕事をしている
  • 60. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** https://linedevday.linecorp.com/2021/ja/sessions/148
  • 61. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** ドキュメントを書く専門職
  • 62. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** え、毎日ドキュメント書いて 給料もらえて感謝される? 夢のようなお仕事では?
  • 63. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 64. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 新しい技術をはじめよう と思ったとき 私たちと技術の間には たくさんの技術文書がある
  • 65. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 技術文書を書くのは 選ばれた特別な人だけが できることではなく 自分にもできること
  • 66. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 自分はまだ 全然詳しくないから もっと詳しくなってから 書こう・・・
  • 67. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 書いてみることで 自分がまだちゃんと 分かっていなかった部分に 気づける
  • 68. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 技術文書を書くと いつか誰かの役に立つ (かもしれない)し 自分の学びにもなる
  • 69. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 誰でもやってみればできること の先に「本を書く」とか 「テクニカルライターになる」 という出来事もある
  • 70. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1.技術書を書いたことで テクニカルライターになった話 2. 技術文書を「書く人」になったときに 知っておくとよいこと
  • 71. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1. 技術書を書いたことで テクニカルライターになった話 2.技術文書を「書く人」になったときに 知っておくとよいこと
  • 72. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 技術文書を 書いている人から よく聞かれる質問
  • 73. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** もっとうまく書けるように なりたいです! どんなことに気をつけて書いたら 文章力が上がりますか?
  • 74. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** いっぱい読んで いっぱい書くといいよ!
  • 75. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 参考にしたいお手本のような表現 使わない方がいいと感じる表現
  • 76. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 少ないパーツで 「なんか作れ」って 言われるとしんどい
  • 77. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 「この言い回し」 「こういう表現」 「こういう説明の仕方」 「こういう構成」
  • 78. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** いいパーツが 自分の中にいっぱいあると 「いい文章」が 組み立てやすくなる
  • 79. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** いっぱい読んで いっぱい書くといいよ!
  • 80. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 実際書いてみると 思っていたより全然うまく書けなくて すごく苦しい・・・
  • 81. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** でも書き上げることが大切!
  • 82. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 書き上げたものは 今後、改善点を見つけて よりよい文章にしていくための土台
  • 83. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 完璧なものだけを世に出そう! (と思っていつまでも出せない)
  • 84. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** いっぱい読んで いっぱい書くといいよ!
  • 85. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 文章力をあげるために おすすめの本とか ありますか?
  • 86. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 日本語スタイルガイド(第3版) 一般財団法人テクニカルコミュニケーター協会 / テクニカルコミュニケーター協会出版事業部 https://www.amazon.co.jp/dp/4902820102
  • 87. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 数学文章作法 基礎編・推敲編 結城 浩 / 筑摩書房 https://www.amazon.co.jp/dp/448009525X https://www.amazon.co.jp/dp/4480095268
  • 88. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 【新版】日本語の作文技術 本多勝一 / 朝日新聞出版 https://www.amazon.co.jp/dp/4022618450
  • 89. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** https://www.youtube.com/playlist?list=PL80ip6bOwQsIfO757li02S42XDdWdnmED
  • 90. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 会社によって呼び方は テクニカルライターだったり UXライターだったり
  • 91. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** ちょっと 伸び悩む時期が やってくる https://www.youtube.com/playlist?list=PL80ip6bOwQsIfO757li02S42XDdWdnmED
  • 92. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 1. 技術書を書いたことで テクニカルライターになった話 2.技術文書を「書く人」になったときに 知っておくとよいこと
  • 93. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** さいごに
  • 94. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** https://linecorp.com/ja/career/position/806
  • 95. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only***
  • 96. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 会議用個室は Discord繋ぎながら Among Usするとき すごくいい
  • 97. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 引用元:https://linecorp.com/ja/pr/news/ja/2021/3912
  • 98. ***Highly Confidential - For Company Internal Use By Authorized Personnel Only*** 人と技術を繋げる 「技術文書」について mochikoAsTech 2021.11.27 オープンセミナー2021@岡山