overlasting.net
overlasting.net 2020 Copyright. All Rights Reserved. The Sponsored Listings displayed above are served automatically by a third party. Neither the service provider nor the domain owner maintain any relationship with the advertisers. In case of trademark issues please contact the domain owner directly (contact information can be found in whois). Privacy Policy
詳細設計書ってあるじゃないですか。 - 室長のひとりごち
「詳細設計書ってあるじゃないですか。」 「あるね。」 「『必要ですか』って聞かれたんですけど。」 「そう。」 「必要ですかね。」 「何て答えたの。」 「成果物で決めているなら必要でしょう、って。」 「成果物なら必要だね。」 「『じゃあ、成果物じゃなければ必要ないんでしょ』って聞かれて。」 「何て答えたの。」 「詳細設計書で何を伝えたいか決まっているの、って。」 「質問で返したんだ。」 「まぁ、そうですが。でも、質問の意味が解らないし。」 「そしたら。」 「設計する人とコード書く人が同じならいらいですよね、って。」 「質問が変わった気があるね。」 「まあまあ。」 「それで。」 「同じ人なら確かにいらない、って。」 「マジで。」 「はい。」 「とっても限定されている条件下での話、だよね。」 「うーん、そうかも…しれないですね。」 「今のビジネスでそんな条件下、存在するんかい。」 「わからないで
わかりやすいREADME.mdを書く
GitHubなどに自分のツールやライブラリを公開するとき，README.mdは重要な役割を担っている．レポジトリを訪れたユーザが自分のツールを使ってくれるか否かの第一歩はREADME.mdにかかっている，と言っても過言ではない．実際自分が使う側になったときも，まずREADME.mdを読んで判断していると思う． 成功しているプロジェクトを参考にしつつ，自分が実践していることをまとめておく．ここに書いていることはあくまで（自分の中で）最低限的なものである．プロジェクトが成長していくにつれてREADMEはあるべき姿に成長していくべきだと思う． READMEの役割 README.mdには大きく2つの役割がある． プロジェクト，ツールの使い方，インストール方法 プロジェクト，ツールの宣伝 元々READMEは前者の役割しかなかったが，GitHubの仕組み上，後者の役割も徐々に重要になっている． さらに
Collaborative real-time editor - Wikipedia
"Online editing" redirects here. Not to be confused with Online editing (video production). A collaborative real-time editor is a type of collaborative software or web application which enables real-time collaborative editing, simultaneous editing, or live editing of the same digital document, computer file or cloud-stored data – such as an online spreadsheet, word processing document, database or
ソースコードからApple標準スタイルのAPIドキュメントを生成するappledocの書き方 | DevelopersIO
サンプルクラスの作成 プロジェクトを作成したら、コメントを試すためのクラスとしてNSObjectを継承したSampleObjectを作成しましょう。 コメントの書式 appledocでは、以下で紹介する特別な書式で書かれたコメントからドキュメントを抽出します。また、もともとHeaderDocやDoxygenの書式で書かれた書式にも対応しているため、簡単に移植できます。 複数行のコメント appledocでは「/** コメント */」のように/(スラッシュ)１つと*(アスタリスク)２つで始まり、*(アスタリスク)１つと/(スラッシュ)１つで終わるコメントを解析対象とします。 /** コメントをかくぜぇ */ 試しにSampleObject.hのクラス定義の上に以下のように書いてみましょう。 SampleObject.h #import <Foundation/Foundation.h> /*
NoTex.ch·論文レベルのドキュメントまで作成できるオンラインエディタ MOONGIFT
wri.peをはじめ、オンライン上でメモをとれるサービスがたくさん出ています。いずれか使ったことがあるでしょうか。この手のサービスはHTML出力を基本としていますが、より高度な文書を作成しようと思うと物足りなく感じることがあるかも知れません。 例えば論文を記述する、どこかに提出するドキュメントを作成する、電子書籍を作成するなどといった場合に使ってみて欲しいのがNoTex.chです。 NoTex.chの使い方 メイン画面です。左側にフォルダツリー、右側が編集ウィンドウになります。 編集はこんな感じ。ツールバーがあってより高度な編集ができるようになっています。 生成されたPDF。2段組みで論文としてそのまま提出できる高品質なレベルとのことです。 例えばこれは700KBを越えるPDFです。大きなサイズの文書でも作成できます。 NoTex.chはreStructuredText、Markdown、
人に見られると綺麗になる - ✘╹◡╹✘
公開されるインターフェースが自動的に全てドキュメントに載ってしまうようなドキュメント生成ツールを使うようになると、ああこのインターフェースは公開する必要ないな、ということに気付いて直そうとする心理が働く。段々公開インターフェースが洗練されていって比較的まともになる傾向があると思う。結果、設計も変わることもある。日々のメンテナンスはだるい。
詳細設計書も問題だけど、それ以上に成果物定義が問題 - プロマネブログ
詳細設計書という名のゴミ | Gm7add9 この手の話題が定期的に上がるわけですけど、毎度同じだよねで終わってしまっては人間進歩しないので、何が問題でどうすればよいのか少し考えてみたく。 詳細設計書は「プログラム説明書」として欲しい。 まあ、元記事も多分業務システムの受託の話の模様なのでSIをターゲットに。 往々にしてSI、特にウォーターフォール開発のプロジェクトの中では、設計書などのドキュメントを多数作成いたします。*1 V字モデル的には、設計から開発に至るまでの間 要件定義書 基本設計書・外部設計書 基本設計書・内部設計書 詳細設計書 プログラム みたいな成果物を作成いたします。 個別の詳細は別のサイトに任せるとして、それぞれ記載する内容を一言で表すと、要件定義書は「スタートとゴール」、外部設計書は「業務とサービスの仕様」、内部設計書は「サービスの構造と機能の分割」となります。 ※た
「自社開発より楽」、KDDIウェブJimdo事業部がマニュアルサービスTeachmeで属人化撤廃
KDDIウェブコミュニケーションズ（以下KDDIウェブ）でWebサイトの作成サービスを提供するJimdo事業部は、2013年末から順次社内向けの運営マニュアルをクラウドサービス「Teachme」に移行、刷新している（写真1）。Teachmeはベンチャー企業のスタディストが開発・提供する業務手順書の作成・共有に特化したサービス。スマートフォンのカメラを活用し、写真とテキストで誰もが統一的なマニュアルを作成できる（関連記事）。現在、ベンチャー企業が開発・提供する特定業務のためのBtoB向けクラウドサービスが続々と登場しているが、そうしたサービスが大手企業の部門や中小企業といった単位で利用され始めていることを示す事例である。
ブロック図生成ツール blockdiag — blockdiag 1.0 ドキュメント
ブロック図生成ツール blockdiag¶ blockdiag シリーズはシンプルなテキストからブロック図などの画像を生成する画像生成ツール群です。 blockdiag を用いると以下のような図が簡単に生成できます。 blockdiag の主な機能: 数種類の図に対応 ブロック図 (blockdiag コマンド) シーケンス図 (seqdiag コマンド) アクティビティ図 (actdiag コマンド) 論理ネットワーク図 (nwdiag コマンド) テキストベースの定義ファイルから画像ファイルを生成 (graphviz 風の文法を採用) 定義にあわせて図の配置を自動的に決定 (自動レイアウト) Sphinx, Trac, Redmine, 各種 Wiki エンジン等、多様なシステムへの画像埋め込みに対応 Enjoy documentation with blockdiag !
綺麗なだけじゃ意味がない！ディレクターが見落としがちな仕様書作成の４ポイント : LINE Corporation ディレクターブログ
こんにちは。ウェブサービス本部の河野です。 ディレクターの業務の重要なものの一つに、仕様をまとめたりドキュメントを作る業務があります。限られた時間の中でシステムを開発しなければならない際に、どのようなドキュメントをどこまで作成するか悩むことも多いかと思います。 そこで今回はディレクターがドキュメントを作成する際の心がけやポイントについて考えてみたいと思います。 １．ドキュメントを作ることが目的とならないようにする 当たり前のことですが、一番重要なのは進めているシステム開発が納期通りに不具合なくリリースできることです。仕様をメンバーに理解してもらうことが第一で、その手段としてドキュメントがあるという優先度を間違えないようにしましょう。 きちんとしたドキュメントの作成には時間が掛かり、変更時の更新にも同じく時間がかかります。また、更新をせず情報が古いままの場合、開発メンバーがそれを最新バージョ
設計書仕様書テンプレート PocketDOC | 株式会社イーイノベーション
弊社サービスをご利用頂き、誠に有り難うございます。 ドキュメントのダウンロード件数が2007年5月の開設以来300000件を突破しました！ 今度ともご愛顧の程よろしくお願いいたします。 PocketDOC(ポケットドック)とはシステム開発に必要な設計書や仕様書などのドキュメントやテンプレートはもちろんのこと、 議事録、納品・検収書、近年話題になっている個人情報に関しての取扱管理表などの ドキュメントやテンプレートも提供しています。 実際に弊社のプロジェクトで使用されているため精度も高く、カスタマイズなしでも利用可能なほどです。 上流工程から下流工程まで広い範囲をサポートしているので、 必要なテンプレートだけをダウンロードして利用することも可能です。 ドキュメントやテンプレートのファイル形式はWord(doc形式)やExcel(xls形式)です。 ダウンロード後、すぐにお使いいただけるように
Haah Doccoy - ✘╹◡╹✘
http://r7kamura.github.com/mmd.js/docs/parser.html https://github.com/r7kamura/mmd.js/blob/master/coffee/mmd/parser.coffee CoffeeScriptで開発しているmmd.js にドキュメントを書こうと思って色々ツールを探した結果、Doccoが良かった。 書くコストが低く、ある程度フォーマットが統一され、 エディタとブラウザでそれぞれに適したフォーマットで読める、というものを探していた。 他にはJSDoc、YUIDoc等を見た。 Doccoは新しく覚えることが少ない点が良かった。 HTML形式で出力してくれる奴は、github-pagesとも相性が良い。 コードリーディングの時に過程を残しておく用途にも良いかもしれない。 $ npm install -g docco $
SEが苦手にしがちなドキュメント力を強化する5つの視点
SEに最も必要なスキルは「伝える力」だと言われています。分業が前提となるシステム開発において、意志の伝達がうまく出来ないことは致命的だからです。 よって、作成するドキュメントにも正しく伝える技術が求められるのですが、しかし多くのSEはドキュメント作成を苦手としているようです。 そこで今日は、SEがドキュメント作成で失敗しがちなポイントと、ドキュメント力を強化するための5つの視点について、『エンジニアのための文章術再入門講座』からご紹介します。 1.SEがドキュメント作成で失敗しがちなポイント SEがドキュメント作成に失敗しがちなポイントは、主に以下の2つです。 相手の関心と不一致 知識差のための説明が不足 例えば、システム開発プロジェクトの部長向けの進捗報告の場面を思い浮かべてください。性格にもよりますが、一般に部長クラスの方が気にするのは「予算を超過しないか」「顧客との関係は良好か」「今
Markdown - Wikipedia
Markdown（マークダウン）は、文書を記述するための軽量マークアップ言語のひとつである。本来はプレーンテキスト形式で手軽に書いた文書からHTMLを生成するために開発されたものである。しかし、現在[いつ?]ではHTMLのほかPowerPoint形式やLaTeX形式のファイルへ変換するソフトウェア（コンバータ）も開発されている。各コンバータの開発者によって多様な拡張が施されるため、各種の方言が存在する。 オリジナルのMarkdown[編集] 「書きやすくて読みやすいプレーンテキストとして記述した文書を、妥当なXHTML（もしくはHTML）文書へと変換できるフォーマット」として、ジョン・グルーバー（英語版）により作成された。アーロン・スワーツも大きな貢献をしている[4]。Markdownの記法の多くは、電子メールにおいてプレーンテキストを装飾する際の慣習から着想を得ている。 Markdown
コンピュータ系技術書を無料で読めるサイトまとめ - 情報科学屋さんを目指す人のメモ（FC2ブログ版）
何かのやり方や、問題の解決方法をどんどんメモするブログ。そんな大学院生の活動「キャッシュ」に誰かがヒットしてくれることを祈って。 特に探すつもりはなかったけど、技術書を無料で読めるサイトに複数遭遇したので、出会った分だけでもとまとめてみた。無料で読めるサイトと言っても、基本的には無料公開されているページへのリンク集という形。 O'REILLY Open Books http://oreilly.com/openbook/ リンク先の右にあるリンクの書籍が無料。左のジャンル分けは通常の書籍一覧なので注意。他のサイトに比べるとだいぶ少ない。 O'REILLY Open Feedback Publishing System (OFPS) http://ofps.oreilly.com/ 出版前の書籍を公開して、フィードバックを受け付けるというサイト。作りかけの本も存在するが、最新の内容が読めると
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Modern Dev Environment Delivered � Koding
今日の翻訳 (Powered by Python ドキュメント)
日本語ドキュメント - Apple Developer
プログラマが欲しい仕様書とは
