タグ

ドキュメントに関するzilog80のブックマーク (2)

  • 作図系ツール・ライブラリまとめ

    diag.md シーケンス図とかフローチャートをしごとで描画することになった場合、 テキストから生成できたら楽なので、それ系のツールまとめ GraphViz http://www.graphviz.org/ C製 Doxygen, Moinmoinなどと連携可能 ブロック図、クラス図、ネットワーク図など PNG, SVGなど 出力可能形式一覧 JavaScriptEmscripten)版もある。リアルタイムプレビュー出来て便利 https://github.com/mdaines/viz.js PlantUML Java製 シーケンス図, ユースケース図, クラス図, アクティビティ図, コンポーネント図, ステート図, デプロイ図, オブジェクト図などめっちゃたくさん作れる PNG, SVG, LaTeX, ASCII出力 なんとワイヤーフレームも作れる。アイコンとかも入れられる。 オ

    作図系ツール・ライブラリまとめ
  • 新人君にドキュメントの作成を頼んで3時間後、進捗を確認したら三行しか書けてなかった。:101回死んだエンジニア:エンジニアライフ

    いろいろな仕事を渡り歩き、今はインフラ系エンジニアをやっている。いろんな業種からの視点も交えてコラムを綴らせていただきます。 ■仰天の新人君 ネットでびっくり仰天な新人君の話を見かける。まだ、ビジネスマナー系の仰天話なら可愛いものだ。社会経験が無いので仕方がないと思える。シャレにならないのは能力に関する仰天ネタだ。 特に技術を売りにするIT系の業務で能力が足りないと致命的だ。コラムの題名にある、新人君にドキュメントの作成を頼んだら、三行しか書けていなかったというのは、私の経験した実話だ。 一般では仰天話かもしれないが、私としては予想通りだった。今回は、こういう新人君をフォローする立場で書いてみる。力無き新人君に代わって、無能な先輩方にツッコミを入れていきたいと思う。 ■できて当然というのは甘えだ できない人に対して、いきなり問題意識を押し付けるタイプの人が一定数いる。まず、こういう人はエン

    新人君にドキュメントの作成を頼んで3時間後、進捗を確認したら三行しか書けてなかった。:101回死んだエンジニア:エンジニアライフ
    zilog80
    zilog80 2015/09/14
    すごくいい先輩だ。人を育てる必要性を知っている。/自分も文章は苦手だった。だからはてぶで100文字程度と格闘しているのだ。
  • 1