タグ

documentに関するatsuizoのブックマーク (6)

  • プログラミングスタイルガイドのスタイルガイド - Qiita

    文書は、プログラミング言語向けのスタイルガイドに向けたスタイルガイドである。 文書へのフィードバックはQiita上のコメントにて受け付ける。 構造 対象を明確にする そのスタイルガイドがどのような状況のどのような対象に向けたスタイルガイドであるか規定すること。 状況や対象は広すぎてはならない。 理由: 対象はスタイルガイド記述者には自明かもしれないが、似て非なる言語に誤用されたり、特定分野のアプリケーション向けスタイルガイドが他分野のアプリケーションを理不尽に拘束したりすることがある。これを防ぐべきである。 良い例: 「文書はRuby on Railsアプリケーション向けのスタイルガイドである」 「スタイルガイドはX社におけるRubyプロジェクトに適用すべきスタイルを規定する」 悪い例: (何も書かない) 「文書はX社におけるすべての開発に適用される ... 述語メソッドや述語関

    プログラミングスタイルガイドのスタイルガイド - Qiita
  • メイキング・オブ・『ひとり社長の経理の基本』。iPadアプリ「UPAD」の活用 | 独立を楽しくするブログ

    『ひとり社長の経理の基』発売決定から発売まで 『ひとり社長の経理の基』、2014年4月25日に無事に発売されましたが、さかのぼると、2013年の7月頃から動き出していました。 発端(2013/7/1) 6月には、別のの企画を考えていたのですが、私の方がいまいちしっくりこなくて、泣く泣く編集者さんに「いったん保留していただけませんか?」とメールしたのです。 を書くにはそれなりの時間と労力がかかり、書く以上売れるものにしなければいけません。 「自分が納得いく」「しっくりくる」というのは条件の1つでしょう。 ただ、そのときのメールのやりとりで、「こういうのはいかがでしょうか?」と提案いただき、再度企画を練りなおしました。 企画案提出(7/11) 企画案を考えたところ、やはりしっくりいかず、7/4から7/9にかけて、編集者さんとメールのやりとり。 そのときのやりとりで、「1人社長のための経

    メイキング・オブ・『ひとり社長の経理の基本』。iPadアプリ「UPAD」の活用 | 独立を楽しくするブログ
    atsuizo
    atsuizo 2014/05/12
    自分が執筆業に関わることはなさそうだけど、社内業務にも活かせそうな事例。
  • ScaleOut | Supership

    「ミライリアルの幸せを、デジタルの力で創る」ことを目指すSupershipグループの社内報です。日々の出来事、メンバーの働く様子や声、未来への想いなど、Supershipグループの”Be Super”なストーリーをみんなでシェアしていきます。

    ScaleOut | Supership
    atsuizo
    atsuizo 2014/01/08
    ソース書くチーム向けに強化されたサイボウズ/ガルーンの社内メールって印象を持った。
  • 【IA】ツールに制約されるWeb設計の発想

    さまざまなことを実現することを想定して多数のツールが作られている。 WindowsMacのアプリケーションもあれば、ASPやSaaSと言われるWebアプリケーションなどもある。 例えば動画のエンコードのような単機能アプリであればパラメーターと目的を遂行するボタンで目的をほぼ余すことなく実現できる。 それに対して目的自体がビジネスやコミュニケーションと言った、「人それぞれ違う」ような概念の場合は、アプリケーションのデザインがもたらす制約は大きい。 例えば、ツイッターのような「140文字」という制約や、昔のmixiのように「新着日記が表示されるのは1日1個まで」などと言った制約は、そのコミュニケーションのあり方に制約をかける。 それと全く同じ文脈で、何かを生み出すツールによる制約によって、クリエイティブの幅に制約がかかっているケースがままある。 例えば、Webの画面設計。 HTMLのコーディ

    atsuizo
    atsuizo 2009/03/02
    同じところで悩んでる。excel方眼紙は「イメージ」作るところまではvisioを代替できるけど、項目定義や処理に関わる文章を書き始めると破綻する。
  • [観] Twitter API 仕様書 (勝手に日本語訳シリーズ)

    [要旨] Twitter API 仕様書の勝手翻訳をしてみました。 [キーワード] Twitter,API

  • 1