テクニカルライティングの基本 2023年版

2023/06/22 1322 users テクニカルライティング Twitter サイボウズ 初版 資料

テクニカルライティングの基本を学べます。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。 サイボウズの2023年度 新入社員向け研修の資料です。 Twitter：https://twitter.com/naoh_nak 2022年版（初版）：https://speakerdeck.com/naohiro_nakata/technicalwriting 続きを読む

仕様書とテストを用いた「AI駆動開発」

2023/02/25 157 users AI駆動開発 テスト

数年前にAIを離れ現在はフロントエンドをやっているのですが、半年くらい前に思い切り引き戻されました。画像生成AIにおけるmidjourneyとstable diffusionの登場です。noteのCTO深津さんが記事を出したと思ったのも束の間、急速に進化を果たしました。 絵柄の固定・ポーズの指定・マシンスペックなど、日々さまざまな問... 続きを読む

FigmaとNotionでUML・経理処理・デザインまでAll in oneな仕様書を書いて、更新・共有を楽にしてる話 - Qiita

2022/12/16 148 users UML figma Qiita Notion 狭間

本記事は Figma Advent Calendar 2022 16日目の投稿です。 仕様書を作るとき、あの情報はこのツールで書いたほうが楽、みたいな感じで、あっちこっちに情報が散逸することがありますよね。 かくいう私も、事業会社でデザイナーとPMの狭間みたいな仕事をしていまして、UMLだのデザインだの、複数のツールを跨いで作業をす... 続きを読む

仕様書の参考例と、こんな内容を仕様書に最低書くといいというお話｜田辺めぐみ｜note

2022/01/19 1200 users Note 田辺めぐみ フェーズ 前提 参考例

よく、仕様書を書いていなくて、書いてみたいけど、具体的な仕様書がネット上に落ちてなくってこまってるって相談を受けるので 「仕様書の記載内容のイメージ」を作りました！ ※前提として「現在仕様書を書いていない、自社開発のMVP検証前後のフェーズのスタートアップ向け」に書いています。 ついでに、システム開発の... 続きを読む

アベノマスク「約15％が不良品」　岸田総理が…

2021/12/21 180 users 岸田総理 アベノマスク 岸田総理大臣 マスク 政府

政府が配布したいわゆる「アベノマスク」に関して岸田総理大臣は、およそ15％のマスクが不良品であったことを明らかにしました。 岸田総理大臣：「品質基準等を明確に定めた仕様書を作成していなかったことなどから、不良品が生じました。約7100万枚のうち約1100万枚、約15％が不良品でありました」 そのうえで、会計検... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく

2021/11/22 692 users JIS規格 観点 チェック体制 設計書 ソフトウェア

経済産業省は11月22日、システム開発時に使う設計書・仕様書などの「作業生産物」のレビュー工程についてJIS規格を制定したと発表した。仕様書などの見直し方や観点などを規格化し、ソフトウェアの品質向上や開発の効率化を促す。 「JIS X 20246」は、設計書・仕様書の見直し作業を「計画作業」「レビューの立ち上げ」「... 続きを読む

設計書・仕様書のレビュー方法を定めたJIS規格登場　チェック体制を標準化しやすく（要約）

2021/11/22 89 users 工程 観点 JIS規格化 要約 経済産業省

経済産業省が設計書・仕様書などのレビュー工程をJIS規格化標準的なレビューの工程や観点などを規定成果物の品質や開発の効率化に期待 続きを読む

予算の作り方｜和田洋一｜note

2021/11/04 609 users 和田洋一 Note 私見 予算 CEO

経営の重要なツールである予算につき私見を書いてみる。 世に予算を「正確に策定する」議論は多く見受けられるものの、なぜ予算を建てるかに対してストレートに述べたものはあまり見ない。 「なぜ」がなければ「どのように」は導けない。 予算とは経営からのメッセージ予算は、スタッフの行動を促すための仕様書 CEOは、... 続きを読む

メモリ 4GB + CeleronのPCを「スペックが不十分」と判断するのは案外難しいかもしれない - Qiita

2021/04/03 173 users 異論 GIGAスクール構想 筆者 Qiita 支障

3月末、アイリスオーヤマ社のノートPCや「GIGAスクール構想」の仕様書が話題になっていました。その多くが「動作に支障をきたすほどスペックが低いのではないか」という批判的なものです。 筆者もこういったPCが「ローエンド」であり、「快適ではない」ことに異論はありません。自分自身や家族のためにPCを購入するなら... 続きを読む

いまこそ「良い仕様書」がチームの生産性の鍵となる。ので、仕様書に含めたい 14 のポイントについてまとめました。｜Fritz | Product Manager @ Mercari｜note

2020/07/20 1507 users Fritz Mercari｜note チーム 生産性 ポイント

新型コロナウイルス感染症については、必ず1次情報として 厚生労働省 や 首相官邸 のウェブサイトなど公的機関で発表されている発生状況やQ&A、相談窓口の情報もご確認ください。※非常時のため、すべての関連記事に本注意書きを一時的に出しています。 こんにちは、フリッツ です。今回はプロダクトマネージャーの日課と... 続きを読む

ASCII.jp：新型コロナ／定額給付金、神戸市はたったひとりの職員が1週間で、申請状況確認サイトを構築 (1/7)

2020/06/11 581 users ひとこと 新型コロナ 入札 行政 請負契約

今回のひとこと 「行政がITシステムの仕様書を作って発注し、入札を行い、請負契約を結ぶという時代は終わりつつあることを強く感じた。特別定額給付金の申請状況等確認サービスは、神戸市の職員自らが構築した。行政サービスを作り上げるひとつの試みであり、今後、広げていきたい」 特別定額給付金の申請状況を確認で... 続きを読む

Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita

2020/05/25 1786 users テクニカルライティング Qiita エンジニア 同僚 苦手意識

はじめに エンジニアにとって、仕様書などの技術的な文章を書くこと（テクニカルライティングとも言います）は避けて通れません。ただ私も20年来多くのエンジニアの方々と同僚として接してきた中で思うのですが、エンジニアの方の中には「文章を書く」ということに苦手意識がある方も一定数いるのではないかと感じていま... 続きを読む

本誌入手のアベノマスク「仕様書」でわかった“欠陥”と国内生産の謎　「命取りになる」と自民党幹部 (1/4) 〈週刊朝日〉｜AERA dot. (アエラドット)

2020/04/28 456 users 答弁 物議 本誌 命取り 布製マスク

政府が新型コロナウイルス対策として、日本の全世帯約5000万世帯を対象に1住所あたり2枚の布製マスクを配布している「アベノマスク」が、物議を醸している。 【本誌が入手したアベノマスクの「仕様書」はこちら】 安倍首相が国会での答弁で、「布製マスクは使い捨てではなく、再利用可能であることから、急激に拡大して... 続きを読む

デザインが苦手な人へ。デザインの四大原則を押さえれば格段にクオリティ上がるよ→素人が作るチラシや仕様書などにも有益 - Togetter

2020/01/07 1403 users Togetter グルーピング 強弱 整列 近接

［デザインが苦手なあなたへ］ デザインの四大原則で、あなたの制作物はもっ〜と良くなる。 ➀近接 → 仲間ごとにグルーピング ➁整列 → 透明な線に揃える ➂強弱 → メリハリを付ける ➃反復 → 見やすい統一感 デザインで迷子になったら四大原則を思い出して、基本に立ち戻ろう！！ pic.twitter.com/VMQbAVdeiT 続きを読む

Wordな職場にSwaggerを定着させようとして失敗したけど結局定着した話 - Qiita

2019/10/29 394 users Markdown WebAPI Qiita Swagger

はじめに 私の職場では、WebAPIの仕様書をWordで書く習慣があったのですが、2018年頃にSwaggerで書くように切り替わったので、そのように変化した経緯を書きます。 何かの参考になれば幸いです。 ちなみに、こちらの記事と同じ職場です。 Wordな職場にMarkdownを定着させるためにやった４つのこと Swaggerとは？ Swagger... 続きを読む

OAuth 2.0 の勉強のために認可サーバーを自作する - Qiita

2019/10/17 282 users Qiita 一種 サーバー 動作 エンドポイント

はじめに OAuth 2.0 の仕様書である RFC 6749 は、認可サーバー（authorization server）の動作を定めています。この記事は、認可サーバーを簡易的に実装することで、OAuth 2.0 の理解を深めることを目的としています。 1. エンドポイント 認可サーバーは Web サーバーの一種で、認可エンドポイント（authorization endp... 続きを読む

「厳密な仕様記述における形式手法成功事例調査報告書」の公開 ：IPA 独立行政法人 情報処理推進機構

2019/07/08 55 users 誤解 手法 低下 形式手法 増加

ソフトウェア開発現場では、日本語で作成する仕様書の記述内容が曖昧である事に起因する製品品質の低下やプログラム不具合対応などの手戻り作業に伴う開発コストの増加が問題視されています。「形式手法」(*1)は、こうした仕様記述の内容から曖昧さを排除し、誤解を招かない仕様書を作成する手法の一つとして注目されて... 続きを読む

『パックマン』最終仕様書、全ページが学会誌に掲載。AI研究の三宅氏らによる開発者・岩谷氏インタビューも

2019/01/07 453 users 三宅氏 学会誌 AI研究 パックマン 生みの親

『パックマン』最終仕様書、全ページが学会誌に掲載。AI研究の三宅氏らによる開発者・岩谷氏インタビューも 人工知能学会が発刊している学会誌の最新号にあたる「人工知能 Vol.34 No.1」にて、『パックマン』の生みの親である岩谷徹氏のインタビューと共に、同作の仕様書が全面公開される。発売日は1月10日、価格は2592... 続きを読む

MarkdownとPlantUMLでソフトウェアの仕様書や設計書を書くための環境構築手順 - EurekaMoments

2018/12/17 126 users Markdown plantUML Graphviz 設計書

背景・目的 Markdownで書くメリット Markdown記法一覧 環境構築手順 1. Visual Studio Codeをインストールする 2. PlantUMLをインストールする 3. Javaをインストールする 4. Graphvizをインストールする 5. Markdown Preview Enhancedをインストールする 環境構築後の動作確認 Markdownでドキュメントを書く際に便利な... 続きを読む

Life is beautiful: ソフトウェアの仕様書は料理のレシピに似ている

2018/11/27 944 users ソフトウェア Life is beautiful レシピ

先日、経済産業省向けの仕事をしている知り合いと食事をしたのだが、彼によると経済産業省の今の悩みは、「IT産業の階層化の弊害によっておこる下流のプログラマーの収入の低下」だそうである。「プライムベンダー」と呼ばれる「上流コンサルタント」たちがインドや中国にも仕事を発注できることを理由に、激しく値切り... 続きを読む

技術者よ、設計しよう、仕様書を書こう | 宇宙科学研究所

2018/11/22 823 users 宇宙科学研究所 技術者

私は、昨年度、工業標準化事業に対する貢献により経済産業大臣から表彰を受けました。編集委員会から私に与えられたテーマは、それについて解説せよというものです。しかし、その技術的な内容については既に本ニュースの2004年6月号において「宇宙開発における標準化と情報化」という題名で執筆しています。そこで、今回... 続きを読む

〜夏休みの自由研究〜 電波時計のサマータイム対応状況を調べてみた

2018/08/20 53 users 電波時計 自由研究 一握り 夏休み 秋葉原

僕は知っています。 ぜひ、みなさんもお手元の電波時計で試してみてください！ と書いても、試してくれる人なんていないことを。 僕は知っています。 説明書や仕様書に書いてあったとしても、書いてあるとおりに動作する機械なんて、ほんの一握りだということを。 というわけで、楽しい夏休みの自由研究です。 秋葉原で... 続きを読む

タベリー | とある仕様書 – Yamotty – Medium

2018/01/29 208 users プロダクト マネージャー 実装 感情 空中戦

グループ共有機能 仕様書の公開に踏み切ったのは、10Xのプロダクトがどうやって作られているか、について部分的に触れてもらえると思ったから。 10Xでは「細かな実装・デザインの白兵戦」・「認知と理解を獲得していく空中戦」を一緒に戦えるプロダクト・マネージャーを育てていきたいと思っているので、この仕様書を読んで「10Xで力を試してみたい！」という方はぜひ以下のフォームから応募してほしい。ユーザーの感情... 続きを読む

WebMoneyがつらい - ncaq

2018/01/25 567 users WebMoney ウェブマネー 順序 地獄 文章

電子マネーWebMoney（ウェブマネー） がつらい. 私はWebMoneyを個人顧客として使ったことはありません. 決済手段として導入しようとしていてとにかく仕様が地獄. 怒りのあまり文章が整ってないですし順序も支離滅裂です. 私の怒りを整理するために書いているのであまり参考にはならないかもしれません. 仕様書が簡単にアクセスできる場所にない ｢問い合わせ｣をしないと仕様書が見れません. 普通に... 続きを読む

AsciiDoc と PlantUML と mermaid.js で素敵なテキストベース仕様書ライフ

2017/11/09 80 users Asciidoc plantUML UML フローチャート

以前からテキストベースで仕様書(PDF)などを管理したいと思っていたのですが、ようやくその環境が整い、一度実際に運用してみてかなりいい感じだったので紹介したいと思います。 基本テキストは AsciiDoc で記述する UML は PlantUML で記述する フローチャートとかは必要に応じて mermaid.js も使う つまり基本テキストで表現・管理できるものはテキストで書く 成果物は PDF形... 続きを読む