ドキュメントに固執せよ - gfnweb
どうして人間集団はこんなにも知見の共有を円滑にできないのか？ 改善にはドキュメントにまつわる各個人の心構え・制度設計・技術的解決の全部が必要だという話をしたい． ここでテーマにしているのは，著名OSSなど世の中にいくらでも知見が転がっている対象ではなく，特に企業内の十数人のチームでクローズドに開発しているなどして集合知に頼れない状況下でのドキュメントについてである． 非常に乱暴な言い方をするなら，「コードとか大部分は誰でも書けるようになるものなんよ，そんなところにマッチョイズムとか感じなくてええねん，我々の知的体力や組織性が真に試されるのはドキュメントちゃうんか」という気持ちです — 画力・博士号・油田 (@bd_gfngfn) June 3, 2022 ドキュメントに書く内容の必須項目或るシステム（ソフトウェアなど）について，そのシステムのことを全く知らない人を想定読者としたドキュメント
【翻訳】Googleのエンジニアがソフトウェア開発する時に必ず書くドキュメント「Design Docs at Google」 - BppLOG
Googleでの「Design Docs」とは 2007年の Google Developer Day Tokyo での鵜飼氏のプレゼンによると「Google で必ず書くことになっているドキュメント」であり、「プロジェクト立ち上げ時の 1～2週間をかけて書く」ものです。 今回は Google のソフトウェアエンジニアである @cramforce 氏が自身のブログで「Googleでの Design Docs」について解説している記事を公開されていたため、氏の許可を得て翻訳しています。 原文： www.industrialempathy.com 関連書籍： Googleのソフトウェアエンジニアリング ―持続可能なプログラミングを支える技術、文化、プロセス オライリージャパンAmazon 読了目安：11分 (目次) デザインドキュメント の解剖学 文脈と範囲 目標と非目標 実際のデザイン システ
設計書には何を書くべきなのか - terurouメモ
設計とは、 要求（やりたいこと）をヒアリングする 要求を要件（何を満たさないといけないのか）に落とし込む 要件を実現するために考えられる手段を洗い出す 手段の検証を行う 検証結果を元に、どの手段を使うかを選定する 選定した手段を合意する（一部要件を満たさない事項がある場合は、代替策や妥協ラインについても合意する） 合意内容を元に、実装や設定に落とし込む をやることである。画面設計や機能設計のように、3-5の検証/選定が薄くなったり曖昧になったりするものはあるが、一般化するとこの流れになる。 設計書には、上記の設計でやってきたことを順番に書いていけばよい。これを文章構成のテンプレに落としていくと、 要求 要件 方式 対応案（いわゆる比較表で書いていくのが楽） 検証結果 選定・合意結果（合意した代替策や妥協ラインについても記載する） 詳細設計（どういう実装にするとか、パラメーターにするとか、細
VSCode上のマークダウン とDraw.ioでドキュメントを作成する - Qiita
VSCode拡張機能 Draw.io Integration導入方法 先人の方がまとめて下さってます。⇒ VSCodeでDraw.ioが使えるようになったらしい！ Draw.ioでsvg形式のファイルを作成する 拡張子を.drawio.svgまたは.dio.svgにしてファイル作成すると、Draw.ioに関連付けられ、svg形式のファイルを作画＆作成できます。 mdファイルにsvgを埋め込む mdファイルに以下のように作成した画像（.drawio.svg)を埋め込むことができます。 マークダウン構文またはimgタグで記述します。 mdファイルの編集画面からDraw.io画面を開ければ... マークダウン構文で記載した場合、画像ファイルを cmd + クリック で開くことはできますが... 残念ながら、テキストエディタが開いてsvgのソースが表示されます。 Draw.i
Googleがコードレビューのガイドラインなど、ソフトウェアエンジニアリング実践のためのドキュメント「Google Engineering Practices Documentation」を公開
Googleがコードレビューのガイドラインなど、ソフトウェアエンジニアリング実践のためのドキュメント「Google Engineering Practices Documentation」を公開 ライセンスはクリエイティブコモンズの「表示 3.0 非移植 (CC BY 3.0)」で、複製や再配布、営利目的を含めた改変や翻案が可能になっています。 Googleで一般化されたエンジニアリングプラクティス Googleはこのドキュメントを次のように紹介しています。 Google has many generalized engineering practices that cover all languages and all projects. These documents represent our collective experience of various best practic
これ1つでどんなドキュメントも作れる！高度な自動化も簡単に実現可能な「Coda」を使ってみた！ - paiza times
どうも、まさとらん（@0310lan）です！ 今回は、あらゆるドキュメントが作れて自分の好きなようにカスタマイズも可能なWebサービスをご紹介します。 簡単に言ってしまうと、Word・Excel・IFTTT・Trelloが融合したようなドキュメント作成サービスになっており、非エンジニアの方でも簡単に高度なカスタマイズができます。 また、知人を招待して一緒にドキュメントを共有・編集したり、パブリックに公開してブログのように使ったり、プライベートで自分専用の秘密メモを作ったり、さまざまなことができるのでご興味ある方はぜひ参考にしてみてください。 【 Coda 】 ■「Coda」の使い方 それでは、実際に「Coda」をどのように使っていけばよいのかを見ていきましょう！ まずはサイトのトップページにある【Sign Up】ボタンをクリックして無料のユーザー登録を済ませておきましょう。 Googleボ
入門 Docker
入門 Docker¶ About¶ Dockerの入門からプロダクションで活用するプラクティスについてのドキュメントです。 プロダクションへ導入するために必要なDockerの概要から設計までをなるべく最短経路で学ぶことが目的です。 想定する読者層¶ WebAPIのようなサーバーサイドのプログラミングをしたことがある Dockerをこれからプロダクション環境へ導入してみたいと考えている初学者 Version¶ Docker 18.09.3 docker-compose 1.23.2 必要な環境¶ Docker Hub のアカウント Docker公式レジストリ Play with Docker DockerをWeb上で動かせる環境 Play with Dockerを起動するのに前述のDockerHubアカウントが必要 Docker for Mac(Windows)の場合VMが間に挟まり挙動が異
超簡単！ 「Google ドキュメント」を使って画像の中の文字をテキストデータにする方法 - 価格.comマガジン
「パソコンとスマホの基本ワザ」は、パソコンやスマートフォンに関する基本ワザや知っておくと便利な機能をていねいに紹介する連載です。“超”が付くほど簡単な使い方から、中上級者でも知っておくと役に立つ情報をお届けしていきます。第63回は、「Google ドキュメント」を使った、画像の文字をテキストデータ化する方法を紹介します。 「Google ドキュメント」を使えば、紙の書類のデジタル化が超簡単 紙の書類を渡されたけど、それをパソコンのデータとして扱いたい。そんなときに便利なのが、画像の中の文字を認識してテキストデータにする、いわゆる文字認識機能だ。この機能をもつアプリはいろいろあるが、アプリをインストールすることなく、「Google Drive」の機能で行う方法もある。 その方法とは、Google Driveに画像をアップロードし、その画像を「Google ドキュメント」で開くだけ。そうすると
「勝手に忙しくしている人」にあまり同情の余地はない。
ビジネスマンは忙しい。 朝出社して、前日に残した仕事の続きをしていると、メールや電話がかかってきて、次々と小さなタスクが積み上げられる。 なんとかそれらをこなしていると昼休みだ。急いで昼ごはんを掻きこんでいると、あれもこれもやらなければ、と気づく。 席に戻った彼は、頭の中でタスクを整理して、優先順位を決め、処理していく。 この調子だと、今日も残業かもしれない。そういえば有休もしばらくとっていない。 ふと窓辺にいる課長を見ると、緩慢な動作で書類に目を通したり、思いついたようにどこかに電話をかけて、どうでもいい話題で盛り上がったりしている。 どう見ても暇そうである。 それなのに、給料はこちらのほうが安いときている。自分に対する評価は正当なのだろうか？ このような光景を会社の中で見かけることは珍しくない。 かわいそうな話だと思う。自分もそうだ、と忙しい彼に感情移入できる人もいるかもしれない。 し
3分LifeHacking：他人の作った書類を閲覧する - ITmedia Biz.ID
営業報告の日報や、見積書、契約書、請求書、稟議書……。社内文書としてテンプレートを用意している会社もあるだろうが、テンプレートにできないような報告書の類もありそうだ。そんな時、他人の作った書類が何かの参考になるかもしれない。 ビジネスではいろいろな書類を作成する。営業報告の日報や、見積書、契約書、請求書、稟議書……。社内文書としてテンプレートを用意している会社もあるだろうが、テンプレートにできないような報告書の類もありそうだ。そんなさまざまな書類だが、他人の作った書類が何かの参考になるかもしれない。日米で盛り上がりつつあるドキュメント共有サイトで、そんな他人の作った書類を見てみよう。 紹介するのは、読み方が難しい「Scribd」、OKWaveが提供する「docune」、2月にリニューアルしたばかりの「Hot.Docs」だ。いずれも投稿したドキュメントを共有できる。しかもYouTubeのよう
フリーでwebデザインをしています。 クライアントより、新規サイトを制作するにあたり、企画書？…
フリーでwebデザインをしています。 クライアントより、新規サイトを制作するにあたり、企画書？のようなものを提出するように言われました。 提出書類として何が必要か（チャートや計画表など） また、そのサンプル（必須）を教えてください。
FPN-なるほどと言われる、企画書の書き方
6．ビジネス分析フレームワークを学ぶ ビジネス分析フレームワークの学習と使い方 ビジネス分析 フレームワークや 経営学 の学習をどうビジネスリサーチに役立てるか、その考え方と留意点について解説します。… 2021.05.08 2021.05.09 115 view 3．ビジネスリサーチの報告書作成 ファクト、ファクト、ファクト〜事実に基づくこと 「What's Your Story?」という提案や提言がないレポートは意味がない、ということがよく言われますが、ビジネスリサーチの報告書は、内容の8〜9割は ファクト … 2021.01.19 2021.05.16 303 view 4．インプリケーションと提言 リサーチを通じて気付いたことは？公開情報から点と点を結ぶイン… インサイダー情報はそのままでは役に立たない！？ビジネスリサーチの依頼の中で、「業界の空気感はどうなっているか？」「この技術
図解サンプル集：図解は、思いを言葉に、言葉をカタチに：思考と行動を具体化する仕事の図解：ビジネスアーキテクトのテオリア
社員研修の担当の方や、研修を行っている士業やコンサルタントの方に 使っていただきたいと思い、図解コンテンツを公開しました。 お好きな図解を選んでお使いいただくことができます。 詳細へ
企画書のサンプルを探しています。雑誌の特集を企画しているものなど、ありませんでしょうか。…
企画書のサンプルを探しています。雑誌の特集を企画しているものなど、ありませんでしょうか。できれば個人作家・評論家の特集などが良いです。
リレーションメイク - 企画書サンプル
ここで企画書サンプルとして公開しているものは、実際に作成・提案した企画書・報告書を、公開できるように、構成・記述をかなり修正し、一般的な流れ・書き方・表記にしたものです。 内容的には、ある企業が、あるときの状況や環境に置かれたときのものがベースとなっているために、この内容や作り方がそのまま他の企業や事業に活用できるものではありません。 しかし、ある人にとって、ある部分については、テンプレートやフォーマット、見本、書き方例、作成例として活用、応用できるかもしれません。 個人の企画書や社内企画書を作成する場合の、参考資料として、サンプル、テンプレートをご活用ください。 ＜ダウンロードの方法＞ ダウンロードは、タイトルをクリックして表示させてブラウザからそのまま保存するか、タイトルを右クリックして「対象をファイルに保存」です。 ＜ご注意＞ データは、PPT、PPTXです。パワーポイントなどPPT
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
技術文書アンチパターン集
夕刊フジBLOG|一瞬で１０ページの企画書を完成させるフォーマット
http://www.mycc.co.jp/create/cre5/