タグ

ブックマーク / qiita.com (189)

  • 技術的な文章を書くための第0歩 ~読者に伝わる書き方~ - Qiita

    はじめまして。ひつじです。 TechBoosterというウェブサイトでAndroidなどの記事をかいてます。Qiitaには初めて投稿します。 vvakameさんの技術的な文章を書くための1歩、2歩、3歩 を見る人の補助的な気持ちで0歩目を紹介します。 記事の構成方法については、vvakameさんの記事で触れられてることもあり、あまり触れません。 読みやすい文章のための心得をまとめました。 0歩というぐらいなので普段から気を付けている(そして完璧には、こなせていない)内容をまとめています。ただ内容については私自身が気を付けていることですので、もっと皆さんにあった良い方法があるかもしれません。参考になれば幸いです。 文章を書くのに大切なことって? 言いたいことを1つに絞る 1つの文章にたくさんの主張を入れると読む人は混乱してしまいます。ですので、なるべく1つのコンテキスト(章、節、項で主張の大

    技術的な文章を書くための第0歩 ~読者に伝わる書き方~ - Qiita
  • 技術的な文章を書くための1歩、2歩、3歩 - Qiita

    ちょっと書きたくなったので書くんじゃーい! この文章を読み終わった時、読者がそれなりわかめ品質な文章を出力できるようになり、どこかに寄稿した時に全面リテイクをらったりしないようになることを目指します。 mhidaka が 0歩目を書いてくれました! 背景 筆者は普通のエンジニアです。その辺の開発とかしてる会社に勤めています。技術系の原稿も書きます。 原稿書きでご飯べてるわけではありません(晩ご飯が豪華になることは稀にあります)。 今まで有能なレビューワー(muなんとかさんとか)編集さんとか(某社の安藤さんとか)とかとかに鍛えていただきました。 この場を借りてお礼を述べておきたいと思います。ありがとうございます。 なお、この文章は2013年10月時点での筆者(わかめ)のやり方です。 将来的にはより良いやり方を見つけるでしょうし、これとは全く違う書き方で上手にやっている人もいると思います。

    技術的な文章を書くための1歩、2歩、3歩 - Qiita
  • AltJSの選び方フローチャート - Qiita

    JavaScriptわかる - YES 型がほしい - YES Flash/ActionScript3が青春だった - YES Haxe - NO DeNAに勤めている - YES JSX - NO TypeScript - NO Ruby or Python が好き - YES coffee-script - NO クラスはほしい - YES EcmaScript6(Traceur Compiler) or CoffeeScript - NO JavaScriptの文法に不満がある - YES https://github.com/jashkenas/coffeescript/wiki/List-of-languages-that-compile-to-JS - NO JavaScript書けよ - NO 関数型わかる - YES 自分の好きな言語に深く精通している - YES 好きな言

    AltJSの選び方フローチャート - Qiita
    foooomio
    foooomio 2014/09/11
    “JavaScript書けよ”
  • Wantedlyで行っている開発者用Macの設定方法(主にインターン用) - Qiita

    Wantedlyでは、開発PCは基的にはMacで統一しており、社員全員にMacbook AirかMacbook Proを支給している。 インターンも最近人数が多いのである程度の数のMacを用意しておいて、それを使いまわすという運用を行うようになってきている。 Wantedlyでは、新しいMacを買ってから行う設定をある程度自動化しているので、今回はこの流れを公開しようと思う。 来はこの作業を行った後、プロジェクトごと(Web/iOS/Android等)のセットアップを行うという流れになる。ここも特にWeb用の設定は結構自動化されている。 Macの初回セットアップ 日語でセットアップ iCloudなどEmailが必要なものは登録しないでスキップ 起動後、Xcodeダウンロードまで Dockにデフォルトで存在しているものを消す 好みの問題だがほぼすべて消してOK 最終的に以下の2つぐらい

    Wantedlyで行っている開発者用Macの設定方法(主にインターン用) - Qiita
    foooomio
    foooomio 2014/09/02
  • https://qiita.com/exilias/items/f8a4a7bfb8cf3010c0a6

  • [iOS] 新言語SwiftがObjective-Cよりも良いところ - Qiita

    さきほどWWDCにて新言語 Swiftが発表されました。 The Swift Programming Language (iBooks Store) で言語ガイドが公開されていたのでザッと目を通してみました。 Objecitve-Cと比較してSwiftがイケてそうなところをパッと気になったところだけ書いていってみます。 変数/定数の型推論がある Objective-Cのように明示的に型を書かなくても型を推論してくれます。 推論で問題ないケースも多いと思うのでタイプ数がかなり減らせそうですね。 ( 変数を宣言する際はvar、定数を宣言する際はletで宣言します。 ) // 型推論 var name = "Shinji Ikari" // 変数の型は推論によりString型になる var age = 14 // 変数の型は推論によりInteger型になる let height = 141.5

    [iOS] 新言語SwiftがObjective-Cよりも良いところ - Qiita
  • 提言: コミットメッセージの一行目には要求仕様を書け - Qiita

    これは Git (や Subversion などのバージョン管理システム) にコミットする時により良いコミットメッセージを書くための提言です。この提言は特にメッセージの一行目だけを対象とします。せめて最も重要な一行目だけでも良いメッセージを書いて欲しいからです。提言をズバリ一言で表すと 一行目には要求仕様を書け です。 背景 プロジェクトによっていろいろ慣習の差はあるものの、一般的には「コミットメッセージの一行目は変更内容の要約を簡潔に書け」とされます。特に Git は、各コミットメッセージの一行目だけを取り出してそれを一覧表示するなど、一行目を特別に処理する機能が多いので、一行目にできるだけ多くの情報を凝縮させることは重要です。またメッセージを一行しか書かない不届きな慣習のプロジェクトでは、十分な情報を持たないメッセージは無用の長物と化します。 良くないコミットメッセージ しかし私は、情

    提言: コミットメッセージの一行目には要求仕様を書け - Qiita
  • vimでhtmlをスラスラ書くためのレシピ - Qiita

    ただの、自己満足乱れ書き ふむ、下々の文章でも見てやるかって人だけ見てくれればおk 対象はvimはじめたいという人から中級者ぐらい vimhtmlファイルを編集するときに知ってると気持ち良くなれるコマンド というか最低限覚えておかないと、コーディング時間が3倍以上になる系のコマンド。 アクション範囲ターゲットの3つの組み合わせコマンド 例)citとタイプ citのcはアクション。cの場合は削除して挿入モードに変更。他のアクションに置き換える事も可。d(削除)v(選択)など。 citのiは範囲。iはタグの中身が範囲でaに置き換えるとタグ全体が範囲になる。上記の場合でaにすると<div></div>ごと消えて挿入モードになる。 citのtはターゲット。tの場合はタグに対して行う。他にも'や"、<>、{}、()と言ったような何かで挟むものに使える。<>のような左右で違う記号はどちらか一方で良い

    vimでhtmlをスラスラ書くためのレシピ - Qiita
    foooomio
    foooomio 2014/05/27
  • ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習

    Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 最近、あまりプログラミングが得意でない人のサポートをする形で、長い時間にわたってペアプログラミングを行っている。そのなかで、気がついた悪い習慣と成長するための良い習慣というものをまとめてみる。 この記事のバックグラウンドとなる体系的知識がになりました。 エンジニアリング組織論への招待 ~不確実性に向き合う思考と組織のリファクタリング あわせて読みたい 経営者マインドが足りない!vs. 現場に任せてくれない!の対立をなくすカードゲームをつくった話 新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 新人プログラマ

    ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習
  • 新人プログラマに知っておいてもらいたい人類がオブジェクト指向を手に入れるまでの軌跡 - Qiita

    Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? あわせて読みたい 新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習 「オブジェクト指向プログラミング」と「関数型プログラミング」のたった一つのシンプルな違い あきらめるにはまだ早い!ソースコードの品質向上に効果的なアプローチ 2015年に備えて知っておきたいリアクティブアーキテクチャの潮流 この記事について この記事は新人向けの研修内容を再編集してお送りいたします。 ここで述べる内容はどのようにして現在のプログラミングスタイルが生まれてきたかを

    新人プログラマに知っておいてもらいたい人類がオブジェクト指向を手に入れるまでの軌跡 - Qiita
  • 新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 - Qiita

    エンジニア組織を強くするためのを出版しました Qiitaでエンジニアリングをめぐる様々なコミュニケーションの問題とその解決策や考え方を書いてきた。それらの背後にあるエッセンスをこの度書籍として出版するに至りました。 エンジニアリング組織論への招待 ~不確実性に向き合う思考と組織のリファクタリング この書籍は、エンジニアリングを「不確実性を削減する」という第一原理で捉え直し、様々なエンジニアリングとその間のコミュニケーションをめぐる現象を説明していくものです。 あわせて読みたい 新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 新人プログラマに知っておいてもらいたい人類がオブジェクト指向を手に入れるまでの軌跡 ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習 #この記事について この記事は、新人向けの研修内容を再編集してお送りします。 この記事の

    新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則 - Qiita
  • MacBookAirで使っている便利ツール vol.2 - Qiita

    ##概要 ###Mac | Mavericks Mavericksの設定については、ブログでも何度か紹介してきましたので、割と簡単にいきたいと思います。 主に、使用しているツールを書いていきます。 ###Windows | Windows7 私の場合、メインとしてCygwinとPowerShellを使っています。 Windows7は、仮想環境上で動作させています。 アプリのインストールは、Chocolateyで行います。 その他、TerminalにConsole Zを使います。 ###Linux | Manjaro Linux 現在、もう一つのMacBookAirには、Manjaro Linuxを直接インストールしています。 ウィンドウマネージャは、Awesomeを使っています。 最初は、Macとのデュアルブートしてみたのですが、どうもしっくり来なかったので、Macは消しました。非常に快適

    MacBookAirで使っている便利ツール vol.2 - Qiita
  • よく使うディレクトリをブックマークする zsh のプラグイン - Qiita

    Qiita 見てたらこんな投稿を見つけた。 Zsh - よく作業するDirをBookmarkするshellスクリプト - Qiita だいたい、よく使うディレクトリに cd したいとき cd ~/work/project/ruby/web とか長い名前を打つのはめんどくさい。$CDPATH を通しておくっていう手もあるけど、タブで補完したときに候補がいっぱい出たりして微妙に便利じゃない。そんなときにこれを使えばディレクトリの移動が簡単になる。 ちょっと改良の余地があるというか、タブで補完できるようにしたらもっと便利になると思って、独立した zsh のプラグインとして書き直したので紹介する。 このプラグインでできること cd-bookmark というプラグインを作った。これをインストールすれば cd-bookmark というコマンドが使えるようになる。 こいつを使えばよく使うディレクトリに別

    よく使うディレクトリをブックマークする zsh のプラグイン - Qiita
    foooomio
    foooomio 2014/03/27
    おお!便利そう!
  • パスワード問合せシステムを作る (clojureのreducers) - Qiita

    現在のパスワードを教えてくれるからといって、「平文で保存してる!くぁwせdrftgyふじこlp‎」と脊髄反射してはいけません。 JALの6桁数字パスワードがどう格納されているか? 古いシステムなのでMD5でハッシュ化していると想定しますが、もちろんsaltは付けているでしょう。 さて、そんなパスワード保管方式で、現在のパスワード問合せに応答するシステムを作ってみます。 パスワードを「567890」、saltを「hoge」として、データベースには"hoge$567890"のMD5値"4b364677946ccf79f841114e73ccaf4f"が格納されているとします。 総当りしてみましょう。 (ns six-length.core (:require [clojure.core.reducers :as r]) (:import [java.security MessageDigest

    パスワード問合せシステムを作る (clojureのreducers) - Qiita
  • MVCの流れを簡単にまとめてみる - Qiita [キータ]

    理解しやすいように適当に遮ったり、言い切ってしまったところもあるがご容赦いただきたい。 MVCの登場 MVCは、SmalltalkのGUIライブラリのモデルとして登場した。 これはGUIアプリケーションを記述する際に、適切なモデル化を進めるのにとてもいい考え方だと思われていたし、実際にそうだった。 これはアーキテクチャパターンとして、それぞれがどのように依存するべきか、どこにコードを書くべきかということを端的に表している。 安定依存の原則というものがある。これは、要件が安定しているモジュールに依存し、要件が変動しやすいモジュールには依存しないようにするという原則だ。MVCアーキテクチャでは、GUIアプリケーションの安定関係をModel > View > Controllerの順でとらえている。データ処理や業務要件というのは安定しており、UIパーツもまた比較的安定している。それらを統合してア

    MVCの流れを簡単にまとめてみる - Qiita [キータ]
  • bundle install するときに vendor/bundle を省略する方法 - Qiita

    bundle install するときに毎度 vendor/bundle を付け加えるのが面倒な人達へ ~/.bundle/config を作り下記の内容を書いておくとok Bundler は bundle コマンドを実行する際のカレントディレクトリから参照できる .bundle/config を local な設定 ~/.bundle/config にある設定を global として拾ってくれる なお、設定は local の方が優先されるっぽい また bundle config で設定の内容を確認できる Register as a new user and use Qiita more conveniently You get articles that match your needsYou can efficiently read back useful informationYou

    bundle install するときに vendor/bundle を省略する方法 - Qiita
  • bundle execを使わずに済む方法(rbenv編) - Qiita

    $ cd $ mkdir .rbenv/plugins $ cd .rbenv/plugins $ git clone git://github.com/ianheggie/rbenv-binstubs.git rbenvにはpluginsという仕組みがあってrbenvに機能を追加できる。ruby-buildもその一つ。「ひとつのことをうまくやる」思想っぽい。 そのpluginのひとつにbundlerとの連携をうまくやってくれるrbenv-bundlerというのがあるんだけど、rbenvはこれを非推奨といってる。パフォーマンスが悪くなったり、バグが多いみたい。 同じようなpluginを探したところ、rbenv-binstubsというものを見つけた。thoughtbotのブログで紹介されていた。 Rails 3

    bundle execを使わずに済む方法(rbenv編) - Qiita
  • Rails開発環境の構築(rbenvでRuby導入からBundler、Rails導入まで)(Macport編) - Qiita

    Rails開発環境の構築(rbenvでRuby導入からBundler、Rails導入まで)(Macport編)RubyRailsMacmacportsrbenv ※お願い:最近時間がなかなか取れず、Rails5.xの時代になったというのに未だに5.xでの確認ができておりません。どなたか、5.xでも記事の内容がうまくいった、と確認されました方はコメント欄にてご一報をいただけますと大変嬉しいです。 (記事は今の所Rails 3.x〜4.2 対応です) (Homebrew編も公開しました) はじめに:Railsをローカルインストールするという発想 今さらですが、Mac環境でrbenvを使って、RubyRails環境を構築するための記事をまとめてみました。 bundlerでgemRailsプロジェクト内にローカルインストールすることで、ruby環境を汚さずにRailsプロジェクトを生成でき

    Rails開発環境の構築(rbenvでRuby導入からBundler、Rails導入まで)(Macport編) - Qiita
  • コールバック……駆逐してやる…この世から…一匹…残らず!! - Qiita

    このテキストは JavaScript のコールバック地獄に疲れたひとのためのコールバック駆逐術指南書です。対象読者は JavaScript道初段くらいの人です。このテキストを読むと、以下のそれぞれの手段における非同期処理制御の仕組み、利点および欠点がわかるようになるかもしれません。 コールバック地獄 jQuery.Deferred async.js Concurrent.Thread generators co fibers Web Workers (※なぜか『進撃の巨人』の一部ネタバレが含まれるので注意してください) それは『何故人はコールバックするのか』という話でしょうか? 非同期処理って面倒ですよね。JavaScriptではいわゆる コールバック地獄 というやつにしばしば陥りがちです。たとえば、Ajax でふたつのファイル hoge.txt と piyo.txt を持ってきて、それら

    コールバック……駆逐してやる…この世から…一匹…残らず!! - Qiita
  • Javascriptでヒアドキュメント 改悪版 - Qiita

    var css = (function(){/* #target-red { background-color: #ff0000; } */}).toString().match(/\/\*[\s\S]*\*\//)[0]; css = css.replace(/\/\*|\*\//g,'');

    Javascriptでヒアドキュメント 改悪版 - Qiita
    foooomio
    foooomio 2013/08/21
    あーくさん