タグ

ブックマーク / riue.hatenadiary.org (3)

  • 新人向け部門研修で Word について 2 時間程語った話 - 暫停使用

    新人が自分の部門に配属されて早一週間。部門研修の一環として、新人に対して Word の使い方を説明する場を設けた。とは言っても 2 時間程度なので、Word の膨大な機能を全て説明し切れるわけでもない。いろいろ考えて、次のような内容で説明した。 文書を作成する上で大切なこと 1 が見栄え。 2 がメンテナンス性。 それらが揃った上で、初めて内容。 Word を使う上での最低限のマナー Word は段落指向のソフトウェアだ。段落とは一つの改行文字までだ。 スペースやタブでインデントをしてはいけない。インデントはルーラーを使って行え。これは絶対だ。 スペースで間隔調整などを行なってはいけない。間隔調整が必要ならタブを使え。スペースで間隔調整を行なうために等幅フォントを使うのは愚の骨頂だ。 箇条書きを「・」で代用する、段落番号を手で振るといった愚を犯すな。箇条書きや段落番号は、Word のそれ用

    新人向け部門研修で Word について 2 時間程語った話 - 暫停使用
  • 『エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方』 - 暫停使用

    9 冊目の著作となる書は、ある意味私らしい「ややズレた」スタイルの書籍となりました。6/29 発売ですが、池袋ジュンク堂では日先行入荷したそうです。 ちなみに、サブタイトルは「現場で使える API 仕様書の作り方」。Javadoc をテーマとした書籍は、恐らく世界初ではないかと。 エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方 作者: 佐藤竜一出版社/メーカー: 翔泳社発売日: 2009/06/30メディア: 単行(ソフトカバー)購入: 15人 クリック: 263回この商品を含むブログ (49件) を見る 書は、意味のある Javadoc(ドキュメンテーションコメント)をほとんど見たことがないという現実を何とかしようと思って書きました。確かに、多くの Java のソースコードにはドキュメンテーションコメントが記述されています。しかし、その多くは「メソッ

    『エンジニアのためのJavadoc再入門講座 現場で使えるAPI仕様書の作り方』 - 暫停使用
  • 『エンジニアのためのWord再入門講座 美しくメンテナンス性の高い開発ドキュメントの作り方』 - 暫停使用

    ある意味、私の原点となるモノが凝縮されていると思う書籍。ようやくお披露目することが出来ました。 エンジニアのためのWord再入門講座 美しくメンテナンス性の高い開発ドキュメントの作り方 作者: 佐藤竜一出版社/メーカー: 翔泳社発売日: 2008/05/22メディア: 単行購入: 53人 クリック: 1,752回この商品を含むブログ (97件) を見る 書の元になったのは、『開発の現場 vol.006』に寄稿させて頂いた「Wordを駆使した賢いドキュメントの作り方」という記事です。この記事では「ドキュメントは1が見栄え、2がメンテナンス性、中身はそれから」という掛け声の元、Word を効果的に利用する技法を紹介させて頂きました。書はその内容を大幅にブラッシュアップしたものです。 開発者の多くは Word が嫌いです。しかし私が見たところ、Word が嫌いと言う開発者で、Word を

    『エンジニアのためのWord再入門講座 美しくメンテナンス性の高い開発ドキュメントの作り方』 - 暫停使用
  • 1