エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita
はじめに 時の経つのは早いもので、私がIT業界に身を置いて四半世紀になってしまいました。 その間、膨大な数の「設計書（仕様書）」を書いて来ましたが、未だに悩み・迷いは尽きません。 それでも、亀の甲より年の劫とも申しますので、私なりの経験則を「個人」と「チーム」の両観点でまとめてみました。 本稿のテーマは、「主に設計書を想定した、開発ドキュメントの書き方」です。 本稿で前提とする設計書は、ExcelやWordで書かれた、フォーマルな（≒納品物になりえる）設計文書、です。 したがって、自社サービス開発よりも受託開発、アジャイルよりもウォーターフォール、を前提として読んでいただいた方が、しっくりくると思われます。 ＜ご注意＞ 本稿の内容は執筆者独自の見解であり、所属企業における立場、戦略、意見を代表するものではありません。 個人的に心がけていること 当該文書の作成目的や位置付けを冒頭に記載する
Google Homeで子供の朝支度を促してみる - Qiita
はじめに うちには幼稚園に通う子供がいます。「バス来ちゃうよ、ご飯急いで！」「遅れちゃうよ、早くトイレに行ってきて！」そんなやり取りが繰り返される毎日。少しだけ険悪なムードになることもあって、はぁ、なんだか朝から嫌だなぁ...。 と、Google Homeで任意の言葉を読み上げることができると知った妻より「これ、使えないの？」との発言。人に指摘されるのを嫌うのは、幼稚園児だって同じはず。ナイスアイデア！ やりたいこと 妻から指定された要件は以下でした。 指定時刻に、指定した文章を読み上げて。 各曜日ごとに読み上げる文章は変更したいな。 読み上げ以外にも、指定時刻に特定の処理を実行できるようにしておいて。 お、おっけー...。 どうやったか 処理フロー 処理フローは、Googleスプレッドシート→Firebase→ラズパイ→Google Homeとしました。 それぞれの連携では（1）Goog
＃Me Too「私も。」｜石川優実｜note
この記事には、 ・グラビアでの露出問題 ・私が体験した枕営業詐欺 ・被害に合わないために という内容が書いてあります。 初めて、自分が実際に体験した「枕営業」について書きました。 今回初めて公開する内容だということ、反応が怖いという思いも正直あり、有料記事ということにさせていただきました。 ※12月22日、もっとたくさんの方に読んでいただきたく、期間限定で無料にしました。いつまで無料かは未定です。 よくグラビアアイドルが暴露する枕営業の記事は見ますが、大抵書いているのは本人のことではないですよね。 「私はやっていませんが、友達のアイドルが」 という文章を見かけます。 私は、他人のことは書いていません。 人様のことを話すのはあまり好きじゃないし、今回Twitterで話題になっている＃metooというハッシュタグを見て思うことがあったので記事にしました。なので私が私のことを書かなければ意味がな
最強のMarkdown編集環境としてのAtom - たけぞう瀕死ブログ
ブログなどちょっとした文章の編集から書籍の執筆までMarkdownを活用しています。これまで試した各種テキストエディタのMarkdown編集支援機能や、Markdown編集専用のツールはどれも満足の行くものではなかったのですが、最近はAtomに以下のようなパッケージを入れた環境が理想に近いMarkdown編集環境を得ることができました。 少し前にエンジニアHubさんで各社のエンジニアの方がオススメのAtomパッケージを紹介するという企画記事があり、私もMarkdown関連のパッケージを紹介させていただいたのですが、この記事では各パッケージを簡単にしか紹介できなかったので、ここでは少し詳しく紹介したいと思います。 employment.en-japan.com document-outline atom.io サイドバーにMarkdownの見出しをツリー状に表示してくれるパッケージです。書籍
灘中校長「教科書採用で圧力」 議員「政府筋からの…」：朝日新聞デジタル
難関進学校とされる私立灘中学校（神戸市）の和田孫博校長が約１年前に書いた文章が、いまネット上で広がっている。灘中が新規参入の出版社「学び舎（しゃ）」の歴史教科書を採択したことに対して、自民党議員から問い合わせを受けたり、抗議のはがきが数百枚届いたりし、和田校長が「政治的圧力だと感じざるを得ない」などと記したものだ。文章の背景には何があったのか。 灘中が教科書を採択した学び舎は、２０１６年度用から中学歴史教科書に新規参入した。「問いや疑問を生み出す歴史教科書」をうたい、現役の社会科教員ら約３０人が執筆、歴史研究者が助言した。日本政府が慰安婦について「お詫（わ）びと反省」を表明した１９９３年の「河野談話」を掲載。中学校の教科書では１０年ぶりに慰安婦の記述が復活したため話題になった。「軍や官憲によるいわゆる強制連行を直接示すような資料は発見されていない」という政府見解も注記している。学び舎による
稼げないWebライターの特徴を、現役ライター講師にガチで聞いた！
みなさん、Webライターの仕事で稼げてますか？ あたし、稼げてない。 最初に比べたら少しは稼げてますが、なんか、こう、大きな声では言えないけど、本当はもっと稼げてる予定だったんだよね……。 「もしかして私、なんかやり方まちがってる？」 「こうやったら稼げるよ！」て情報は簡単に探せるけど、「これやっちゃダメだよ！」って失敗例は意外と見つからない。 でも、そんなことを都合よく教えてくれる相手がいるかしら……あっ、いたーーー！！ というわけで、この人にお話を聞いてきました！ シングルマザーから最高月収50万！なつみとさん なつみと（元・吉見夏実） 1984年京都市生まれ。 シングルマザーだった2012年に、まったくの初心者からWebライターを始め、4か月で月収20万円稼げるように。その後も月収が上がり続け、現在は新しい働き方について講演するセミナー講師としても活動中。著書に「頑張っているのに稼げ
ペダリング考察 ── 踏むのは一瞬でいい？
ジイチャンライダーが，ペダリング効率を気にしながらトレーニングをしています。 「効率のいいペダリングの方がパワーが出る」 という命題が必ずしも正しいとは限りませんが， 「同じエネルギーを使うのなら効率がいい方が得」 という命題はかなり正しいだろうと思います。 なにより，限られた力を効率よく使いたいというのは，ぼくのような年寄りライダーにとっては大切な課題です。 最近学んだこと，考えたことを書き留めておきたいと思います。 【 ペダリングのコツはドリブル？ 】 NHK の自転車番組 『チャリダー』 に出演している，猪野学さんが自転車サイト 「Cyclist」 に連載している文章から。 猪野学の坂バカ奮闘記〈13〉 「ペダリングは1日にして成らず」 “39.3％”のどん底からの復活劇 より まず最初に取りくんだのが，このペダリングの改善だった。 困った時の ｢山の神｣ 頼みで，森本誠師匠に助けを
今日から使える文章校正テクニック | DevelopersIO
渡辺です。 昨日のエントリーが結構反響大きめだったので、第二弾です。 文章校正をしていてよくあるパターンを幾つか抽出してみました。 ただし、前回紹介しているパターンは除外していますので、あわせて確認ください。 重複を減らす 文章校正の基礎は 重複を減らす ことです。 次の文章を見てみましょう。 AWSを使い慣れている人にとっては簡単な作業ですが、使い慣れていないと戸惑う所も多いところです。 この文章がくどく感じる理由は、「使い慣れている」が重複していることです。 前後関係もありますが「ところ」がなにを指しているのかも曖昧ですね。 後半の「使い慣れている」を削除し、バランスを取るために作業を後ろに移動しました。 さらに、前の文章を受けるため、「これは」を追加します。 これは、AWSを使い慣れている人にとっては簡単ですが、そうでないと戸惑う作業です。 スッキリしました。 しかし、「慣れていると
リーダー(管理者)ではなくエンジニア(実務者)でありたいと願う人々へ - おうさまのみみはロバのみみ
「お前は向いていないんじゃない、やってないだけだ」 この一文を読んでほんの少しでもなにかを感じた人は是非とも↓の本を今すぐに読むべきだ。 エラスティックリーダーシップ ―自己組織化チームの育て方 作者: Roy Osherove,島田浩二出版社/メーカー: オライリージャパン発売日: 2017/05/13メディア: 単行本（ソフトカバー）この商品を含むブログ (1件) を見る 本著はみんなが考え、感じているリーダーシップという曖昧模糊な概念に対して具体性をもたらせてくれる。 それは「チームリーダーの役割は優れた人材が育つのを助けること」と定義付けていることだ。 このシンプルである意味で本質をついている定義付けが本著を名書たらしめているとぼくは思う。 この本の構成は1部〜4部(おおよそ本書の半分ほどを占めている)までが著者によるリーダーシップとはなにか？3つのフェーズの分類とそのときに期待さ
超会議2017でマストドンブースの運営スタッフをした
序 私は江添亮、ドワンゴ社員だ。超会議2017で運営スタッフをした。このブログ記事は個人的なものだ。株式会社ドワンゴの見解ではない。こう書かなければならないのは悲しいことだ。結局、国語教育で存在しない作者の意図を答えさられた人が多いようだ。ちなみに、この文章はマストドンとfactorioがやりたくて仕方がない合間を縫って後ろ髪を引かれながら書いた。もし将来、この文章を使って「作者の意図を答えよ」という問題が出題されたときには、「作者はマストドンとfactorioの中毒者であるが我慢しながらこれを書いた」と答えるのが正解だ。 超会議2017リハーサル 概要 | ニコニコ超会議2017 公式サイト 超会議2017での私の割当は、神エクセル方眼紙で公開された。自由な表計算ソフトウェアであるLibre Officeでみてみると、私はゲームエリアにアサインされていた。 やった。事前に提出した希望通り
無職でホームレス。そんな男が何千人もの人をHIV感染から救った #BFJ_LGBT
2016年、クリスマスの数日前のこと。かかってきた電話は、それまで誰も予想できなかったような内容だった。 シーナ・マコーマック教授は、HIVウィルスを追跡し、それと闘うことに生涯を捧げてきた疫学者であり、世界でもっとも高い評価を受けるHIV専門医だ。マコーマック教授はその日、電話の相手に対して、トップニュース級のメッセージを伝えた。この12カ月間で、HIV感染症の診断を受ける男性同性愛者の数が40パーセント、イングランド全域では3分の1も減ったという知らせだ。 HIVウィルスが発見されてから35年以上が経つが、これほど大幅に減るのは異例のことだ。このあまりにも大きい数字は、医学界では驚きを通り越して虚偽にさえ見えてしまう。だが、この数字は本当だった。 この物語の背景には、秘密裏に何度か行われた会合と、人々のネットワークがあった。その中心にいたのは、ある男性だ。医学の歴史が変わった陰には、人
いかにしてJavaScriptを教えるか - mizchi's blog
経緯 ドワンゴ様から恵贈頂いた。 高校生からはじめる プログラミング 作者: 吉村総一郎出版社/メーカー: KADOKAWA発売日: 2017/04/14メディア: 単行本この商品を含むブログを見る …読んでみたけど、HTML/CSS/JS の初歩的な部分を、初学者にやらせるとこうなる、という素朴な世界観で、CSSフレームワークもJSライブラリも出てこない。いや、出せと言ってるわけじゃない。理解せずにフレームワークを使う習慣がつくと、スクリプトキディ的な振る舞いによっていくし、教える側としても、変数が大きくなってコントロールできないのが問題だろう。 じゃあ基礎を抑えたとして、この先どう教えるといいんだろうな、というのは、たしかに自分も前から考えてはいて、それを書いてみる。 この文章のターゲット JavaScriptを教える人、またはポインタがあれば自学できる中級者以上 追記: すべての初学
社内ライターさん向けライティングマニュアルを公開します。 - アフィリエイト戦記
どもです、水野です。 社内にライターさんを抱えてから、１年と数ヶ月が経ち、社内ライターさん向けのライティングマニュアルが出来上がってきたので公開します。 また、2015年の6月頃に下記の外注ライターさん向けライティングマニュアルを公開しているので見比べてもらうと外注・内勤の違いが見えて面白いかもしれません。 社内向けマニュアルは2015年の春頃に作り始めましたが、100回以上のバージョンアップをしています。そして下記マニュアルを元にライター初心者の方が 看護師転職ほっとの記事を書きました。 ※社内向けマニュアルをほぼ100％コピペして貼り付けた形なので、伝わりにくい部分もあるかもしれません＞＜その時には気軽にTwitterでもコメントでも質問してもらえると助かります。 1.(記事作成の大前提1）内容は狭く深く 記事の内容は広く浅くではなく、狭く深く執筆してください。1つの項目に対して深く内
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://twitter.com/MIYUKI__ONO/status/895476090046529536