タグ

tipsとドキュメントに関するcvyanのブックマーク (7)

  • HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方

    HowToWriteAnEffectiveDesignDocument - 設計文書のうまい書き方 目次 この文書について 設計文書のうまい書き方 なぜ設計文書を書くのか 良い設計とは何か 同僚の開発者に向けて書く 第 1 節に書くこと: プロジェクト/サブシステムの目的を示す 第 2 節に書くこと: 設計に使う高レベルなエンティティを定義する 第 3 節に書くこと: 個々のエンティティに関する低レベルの設計を書く 使い方 設定 モデル 相互作用 第 4 節に書くこと: 利点, 前提, リスク/懸念事項 マネージャ向けに書くこと 最後に 設計文書のうまい書き方 この文書について "How to Write an Effective Design Document" の日語訳です. http://blog.slickedit.com/?p=43 推敲歓迎: 誤訳, タイポ, 訳語の不統一,

  • Changelogのための英文テンプレート集 - ぴょぴょぴょ? - Linuxとかプログラミングの覚え書き -

    Changelog英語で書く際に参考になるようなテンプレートをまとめてみました.git や svn のコミットログにも使えます. このエントリは今後も逐次更新を続けます(最終更新2018/11/01) リリースノートの英文についてはRelease note のための英文テンプレート集 - pyopyopyo - Linuxとかプログラミングの覚え書き -に分離しました git等のcommit メッセージにも使えます 以下,例文. バグ修正した場合 修正した場合 → fix を使うのが定番です Fixed a performance regression. (パフォーマンスが低下するバグを修正しました) Fix possible memory leak Fixed an issue where some devices would display the wrong image. (いく

    Changelogのための英文テンプレート集 - ぴょぴょぴょ? - Linuxとかプログラミングの覚え書き -
  • steps to phantasien t(2007-07-06)

    昔の同僚が退社してベンチャー仕事をやるという. 門出を祝う宴会に, 昔のよしみで呼んでもらった. ついでに古巣の近況を聞く. ひとつ嬉しい知らせがあった. 以下その自慢話. ある夏, 私は社内ライブラリのチュートリアルを書いた. そのチュートリアルが, 今でも改訂されながら参照されているという. のみならず新人プログラマの研修教材として広くとりいれられつつあるそうだ. 私はとても嬉しくなった. もちろん手柄は改訂を続け, 様々な改善を続けた彼らのものだ. それでもなお私は喜びを隠せない. 自分が去った今も文章だけが生き続けている. 私は平凡なプログラマだから, 自分のコードが生き残れるとは思えない. 一方ボランティアで仕事の合間に書いた文章は読み継がれている. 価値のあるものが生き残るのなら, 私のなした価値は(コードではなく)文書にあったことにある. プログラマとしては悲しいけれど, 会

  • PHP4なスクリプトをPHP5へ移行する際に発生する7つの問題 | Shin x blog

    2007/11/13: 3.と4.が同じ内容となっていましたので、4.の内容を変更しました。 ここ最近PHP4.1.2で稼働していたシステムをPHP5.1.6へ移行しています。 移行の際に発生した問題とその対応をメモしておきます。 ちなみに全ての内容がPHP4->PHP5で必要なものではないです。PHP4も4.1/4.2/4.3/4.4の間でちょこちょこ変わっているので、一部の内容はPHP4間の移行でも修正が必要になります。またPHP4.4に適応しているスクリプトをPHP5へ移行するなら修正内容は少なくなります。 1.Notice: Only variable references should be returned by reference 「function &method()」と定義しているメソッドでスカラー値を返すと発生します。 <?php class Hoge { functi

  • 構成は「結・承・転・提」:日経ビジネスオンライン

    何からどういう順番で書けば、うまく相手に伝えることができるのか――。 報告書でもメールでも、いざ文章を書こうとすると、必ず「構成」の問題に突き当たる。悩んでいるうちに、どんどん時間が過ぎ、文書1枚に1日がかり…などということはないだろうか。 何も難しく考える必要はない。文書コンサルタントの小川悟さんによれば、ビジネス文書の構成の基形は「結・承・転・提」。結論を最初に書き、提案で締めることを意識して書けばいい。悩んだ時には、迷わずこの構成を採用しよう。大概の文書はすっきりまとめられるはずだ。 「文章は“起承転結”と言われますが、ビジネス文書は違います。ビジネスのコミュニケーションは、まず結論ありき。続いて、提案や対案が求められることが多いでしょう?文章もその形式が好ましいのです」 メールなどの短めの文章なら、結承転提の各パートをそれぞれ1段落でまとめ、全体を4段落で書き上げるのがベストだ。

    構成は「結・承・転・提」:日経ビジネスオンライン
  • 【特集】正式版完全対応! Internet Explorer 7 CSS攻略法 (1) 01 はじめに IE7日本語正式版のCSS実装を検証する (MYCOMジャーナル)

    Internet Explorer 7日語正式版 Internet Explorer 7(IE7)の日語正式版がリリースされた。現在はまだダウンロードしてインストールする必要があるが、2007年4月をめどに、Windowsの自動アップデートで「優先度の高いアップデート」として配布される予定だ。「IE7ではWebページの表示が崩れる」といった問題が出る場合、それまでには対応を済ませておきたい。 そこで稿では、IE7 beta2のCSS実装検証を元に、IE7日語正式版における変更点やバグをまとめる。また、IE6以下との下位互換やモダンブラウザとの互換性を保ちながらバグを回避する方法、CSSハックについても検証する。 新規対応機能一覧 未対応機能一覧 修正済みバグ一覧 未修正バグ一覧 CSSハック一覧 参考 CSS実装徹底検証! そこが知りたいInternet Explorer 7 なお

  • Ajaxチュートリアル集126個:phpspot開発日誌

    AsH: Top 126 Ajax Tutorials Ajaxチュートリアル集126個。 Ajaxの入門、ブックマークレット、チャット、ドラッグ&ドロップ、動的コンテンツ読み込み、オートコンプリート、ファイルアップロード Lightbox風画像表示、キーワードサジェスト、インクリメンタルサーチ、プログレスバー、角丸、リストのソート、ツリー、投票など、ありとあらゆるチュートリアルがまとまっていて、やりたいことを実現する際に使えそうです。 これだけのリファレンスがあるんですね。驚きです。 関連エントリ ドラッグ&ドロップが簡単に出来るJavaScriptライブラリまとめ WEB開発者のためのリソースを集めたリンク集 JavaScriptデバッグツール集 JavaScriptでマウスホイールイベントを扱い、スクロールも停止する方法 高速&シンプルなJavascriptテンプレートシステム『RN

  • 1