技術文書の書き方
howto-tech-docs.md 技術文書の書き方 このメモは、私（@ymmt2005）が長年にわたってソフトウェアプロダクト開発に関わってきて 2022年現在こうしたほうが良いと考えているベストプラクティスです。 科学的な分析等に基づくわけではない経験則であるため、今後も随時見直すことがありますし、 ここに書いてあることが常に正しいわけでもあらゆるソフトウェア開発に適するわけでもありません。 しかしながら、実務経験が豊富で、モダンな技術スタックに明るいエンジニアの経験則は一定の 役に立つのではないかと考えて記します。 技術文書とは ここでは、ソフトウェア開発で技術者が書くべき文書ということにします。 ソフトウェアエンジニアにも役割がいろいろあり、アーキテクトと independent contributor では書く文書が違うということはあるでしょうけれど、ここではごっちゃにします。
デザインのバージョン管理をする世界
僕の同僚のデザイナーはデザインツールにSketchを使っている。デザインは区切りのいいところまで出来ると保存してDropboxで共有してくれる。最近ではGitHubでSketchファイルを管理することも試しているようだ。GitHubで管理することで過去に遡ったり、ほかの人の作業をマージできたりする。ただ、Sketchファイルはプログラムのソースコードのようなテキストファイルではなくバイナリファイルだ。この違いでGitまたはGitHubの便利なものの多くが使えていないんじゃないか。 先日Sketchファイルをテキストファイル(JSON)として管理できるツールを公開したので、どういうモチベーションで作っているのか書いてみようと思う。ツールはまだ完璧ではないが、ぜひ使って意見をもらえたらと…思う 🙇🏻 テキストファイルになるとできることあぁ、デザイン全体のボーダーの色が淡くなったのいつだっけ
MacBookでDeleteとBackSpaceを使い分ける | 009th tech log
WindowsのPC（特にデスクトップ）を使っていた人がノート型のMacに切り替えると、「delete」キーの挙動に少し戸惑うのではないかと思います。 Windowsでは、Enterキーの上に「BackSpace」キーがあるのが一般的。「BS」と表記されていることもありますね。 「BackSpace」を押すと、入力中の文字のうち、一つ前（カーソルの左側）の文字を消去します。 ほかに「Delete」キーもあって、こちらは一つ後（カーソルの右側）の文字を消去します。 ノート型のMacでは、Enterキーの上にあるのは「delete」キー。 名前は「delete」ですが、挙動はWindowsの「BackSpace」キーと同じく、一つ前（カーソルの左側）の文字を消去します。 ノート型Macの場合、Windowsの「Delete」キーにあたる、一つ後（カーソルの右側）の文字を消去するボタンはありませ
ソローの名言・言葉（英語＆日本語） | 名言+Quotes | Page: 3
ソローの名言（3） 私は人生をあるがままに楽しむ。たとえ救貧院に住んでいても、楽しい、胸が踊る、輝かしい人生が送れるはずだ。夕日は富豪の大邸宅からも救貧院の窓からも、輝かしく照り返す。 ソローの名言 信ずるところに従って生きなさい。そうすれば世界を変えることができます。 ソローの名言 人間の精神世界には、自ら探検していない、幾つもの大陸があり、海がある。 ソローの名言 貧しくとも、君の生活を愛したまえ。 ソローの名言 わたしの唯一の義務。それは、常に、私が正しいと思うことを行うことである。 ソローの名言 音楽は音の結晶である。 ソローの名言 支配することが最も少ない政府が、最良の政府である。 ソローの名言 自分の足で立っている者は、決して孤立していない。 ソローの名言 真に素晴らしい本は内容以上のことを教えてくれる。その本を置き、仕入れた知恵を試したくなる。読むことで、行動せずにいられなく
t-hiroyoshi-blog
eval: それぞれのモジュールはevalとして実行され//@ sourceURLが付けられます source-map: SourceMapを完全に別ファイルとして生成します。output.sourceMapFilenameで設定が可能です hidden-source-map: source-mapと同様SourceMapを別ファイルとして生成しますがバンドルに参照コメントを含みません inline-source-map: SourceMapはDataUrlとしてバンドルされます eval-source-map: それぞれのモジュールはevalとして実行され、SourceMapはDataUrlとしてevalに追加されます cheap-source-map: SourceMapは列を無視して生成されます。loaderで読み込まれたSourceMapは無視されます。 cheap-module-
Primer - GitHub製。みんなで使えるデザインフレームワーク MOONGIFT
企業やプロジェクトによってデザインガイドラインは自ずと必要になってきます。それが社で働くデザイナーの共通認識になる訳ですが、例えばFacebookアプリを作る際にはボタンやデザインをFacebookっぽくしたくなるのではないでしょうか。つまりデザインガイドラインは社内だけでなく社外の人にとっても有益なのです。 そこで登場したのがPrimerです。PrimerはGitHubが作り、使っているデザインガイドラインになります。 Primerの使い方 スクリーンショットを多めで紹介します。まずはグリッド。 ヘッダー。h1〜6まで対応。 テキスト。若干小さめ？ インラインテキストの装飾。 ボタン。ここはGitHubっぽいですね。 ボタングループ。こういうのもGitHubで使われていますよね。 フォーム。シンプルです。 フォームグループ。縦に並べる時に使えます。 メニュー。アイコンはオプションです。
シンプルなHTMLで実装することにこだわったレスポンシブ対応の汎用性に優れたフレームワーク -Turret
シンプルなHTMLでセマンティックに実装することにこだわった、アクセシブルでレスポンシブ対応のサイトをより簡単に制作するためのフレームワークを紹介します。 MIT Licensesで、個人でも商用でも無料で利用できます。 Turret Turret -GitHub Turretの特徴 Turretはアクセシブルで、セマンティックで、レスポンシブ対応のサイトをより簡単に制作するためのフレームワークです。 レスポンシブ対応 読みやすいマークアップを使い、レスポンシブ対応のグリッドやエレメントを汎用性に優れたclassを使って実装しています。 Design First 直感的なユーザインターフェイスのために、文字の定義とカラーパレットにフォーカスしています。 No JavaScript スクリプトは使用せず、LESSベースでネイティブのWeb要素を採用しています。 セマンティック マークアップは
ふわっと切り替わるスライドショーサンプル1
合計5枚の写真が、3秒ごとに切り替わります。 記事に戻る ※このページで使用している「Simple jQuery Slideshow Script」は、Jon Raasch氏によって作成されたスクリプトです。
コネクションプーリング - naoyaのはてなダイアリー
ときどき、たまたま自分がそのとき考えていたことについてそれを補強するような材料が偶然たくさん集まってくる、なんてことがあります。そんな出来事があったので、ちょっとブログを書いてみようかなと。 以前に HBFav を作ったときこんなことを書きました。 Mark Zuckerberg は、いずれみんな、ニュースは友人知人経由で知ることになるだろうと言っていました。自分もそうなるだろうと思います。 4年ぐらいが経ちましたが、その思いは以前よりも増して確信めいたものになってきています。 ところで先日、Twitter の iOS アプリに「ニュース」という機能が追加されました。人によっては出てないそうなのでまだテスト中か、もしくは既に削除されているのかもしれないですが。 この機能についての自分の感想は以下のようなものでした。 もうすこし補足します*1。 Facebook や Twitter のような
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - niiyz/Laravel-DDD: A sample applications that make domain driven design in Laravel.
入門 名前
system-design-primer/README-ja.md at master · donnemartin/system-design-primer
http://gaearon.github.io/react-dnd/examples-sortable-simple.html
ビジネス英語 ～したい させて頂きたい We would like to
GitHub - gongo/json-reformat: Reformat tool for JSON
Null と空文字について(SQL Server) - Database Expert会議室