良いコードとは良い感じのコードである - ennui's blog
こんにちは、imazです。10年ちょっとRailsエンジニアをしています。 インフラは苦手、CSSやJavaScriptも得意ではない、アーキテクチャとか設計も得意ではない… SQLとかデバッグが好きです。答えがあることが好き！ 作業中めちゃくちゃ独り言が出るのでオフィスで働けないタイプです。 Re: 良いコードってどんなコードですか？という質問を受けたら何と答えるか snoozer05.hatenablog.jp 今日はしまださんの記事を読んで、私ならどう答えるかなぁ、自分の場合はこうだなぁ、と思ったことを書いておきます。 良いコードを書くために 私がコードを書くときに心がけているのは「コードがなぜそうあるのか説明できるようにすること」です。 コードの一行一行に対して、どういう選択肢があってなぜそのコードを選んだのかというのが理解できているのが良い状態だと思っています。 簡単な例 たとえ
「コードに早まってDRY原則を適用しないこと」とGoogleが呼びかけ
Googleに存在するコードを読みやすく保守しやすい形に保つ取り組みを行うグループ「Code Health」が、「DRYを早まって適用しないこと」と題した記事を公開しました。 Google Testing Blog: Don't DRY Your Code Prematurely https://testing.googleblog.com/2024/05/dont-dry-your-code-prematurely.html DRYは「Don't Repeat Yourself」の略称で、コードを重複させないことを重視する考え方です。重複するコードが存在していると、特定の機能を変更しようとした時に同じ機能を持つ部分を全て探して同時に変更する必要があり、見落としやミスが発生する危険性が高まります。一方、コードの重複を防げていれば一カ所だけを変更すればOKというわけ。 一見DRYを厳しく適用
JSON Schema Store
JSON Schemas are available for the following {0} files: Auto completion In supported JSON editors like Visual Studio and Visual Studio Code, schema files can offer auto-completion and validation to make sure your JSON document is correct. See a list of editors, validators and other software supporting JSON schemas. Tooltips When a JSON editor supports schemas, tooltips can help inform the user abo
私がTDDを実践しない理由（翻訳）｜TechRacho by BPS株式会社
概要 元サイトの許諾を得て翻訳・公開いたします。 英語記事: 37signals Dev — Pending tests 原文公開日: 2023/03/01 原著者: Jorge Manrubia -- 37signalsのエンジニアです 日本語タイトルは内容に即したものにしました。 私は「テストファースト」で作業することも、テストでコードの設計を支援することも、めったにありません。 最近の私は、37signalsである新しいことに取り組み始めました。何も決まっていない白紙の状態なので作業はすいすい進み、来る日も来る日もこってりしたプルリクを作成しています。会議に先立って早めに投げておきたいと思っていたプルリクには、もれなく以下が含まれていました。 ご覧のように、私はほとんどの場合テストを最後に書いていることが見て取れます。例外があるとすれば、テストを書くことで最短で結果をフィードバックで
UUID v6, v7, v8 : タイムスタンプでソートできる新しい UUID のドラフト仕様 - kakakakakku blog
ID を採番するときによく使われる UUID Version 4 の課題として「順序性がなくソートしにくい」という側面があり，ULID (Universally Unique Lexicographically Sortable Identifier) を使えばソートできるようになるという記事を前に書いた． kakakakakku.hatenablog.com 関連して調査をしていたら，標準化団体 IETF (Internet Engineering Task Force) によって，UUID Version 6, 7, 8 という新しい仕様が提案（ドラフト段階）されていることを発見した❗️UUID Version 6, 7, 8 の目的を簡単にまとめると「タイムスタンプ情報を使ってソートできる ID を採番できるようにする」となり，もしこの仕様が取り込まれると，UUID を活用する幅がさ
YAMLでyes,noというキーは使用できない
Rails にて true, false に対するマークを locale に登録しようとしてこんな yml を書いた。
バベル案内での「STLの作者がOOPは嫌いだと言ったという話」 - so what
www.aoky.net 昔読んだSteve Yeggeの「バベル案内」のC++ の話に「STL作者が OOP は嫌いだと言っていてショックを受けた」ということが書いてあって、ふーんと思っていたが、最近Alexander Stepanovのインタビュー記事を読んでいてそれっぽい話があった。 www.stlport.org Yes. STL is not object oriented. I think that object orientedness is almost as much of a hoax as Artificial Intelligence. はい。STL はオブジェクト指向ではありません。オブジェクト指向は、人工知能と同じくらいデマだと思います。 この人の別のインタビュー記事も面白い。 stepanovpapers.com Using animals as an exa
Sourceless - The Documentation Triangle
sourceless index about contact The Documentation Triangle (or, why code isn't self documenting)At some point in your coding career, you've probably heard something like: "My code is self documenting" or "Code IS documentation" These statements can be hard to argue against, especially if they come from someone who is more experienced than you. A lot of the trouble is that they are not wrong – well,
bkブログ
bkブログ プログラミングやバッドノウハウについてのブログ 2004-2011年に書いていたブログのアーカイブです。 机の上のもののワイヤレス化 - Microsoft Arc Keyboard の導入 iPodは何を変えたのか? 人が問題にぶち当たったときには、どうするか? ソフトウエアの肥大化について、の続き ソフトウェアの肥大化について ある程度の年齢を迎えたプログラマが抱える悩み Unicode の雪だるま 設定ファイルの整理 - Emacs 編 設定ファイルの整理 - zsh 編 パターン、Wiki、XP ～時を超えた創造の原則 マッキントッシュ物語 - 僕らを変えたコンピュータ GNU diff の地味だけど便利な機能 C++ の string と vector の reserve() の挙動 暗号化 - プライバシーを救った反乱者たち Best Software Writin
ドメインモデルの完全性と純粋性 - kawasima
ドメインモデルには、完全性と純粋性、そしてアプリケーション性能の3つ全てを同時に満足させることは難しい場合があるという話。
「100円×3個＝301円」問題でセブンが公式に謝罪 見習うべきは「イオン方式」か
「100円×3個＝301円」問題でセブンが公式に謝罪 見習うべきは「イオン方式」か：お客の混乱を回避する狙い（1/3 ページ） 「事前の告知が不足しておりましたことをお詫び申し上げます」 セブン‐イレブン・ジャパンは9月18日、こんな謝罪文を公式Webサイトに掲載した。セブンは消費増税に対応するため、9月16日から支払金額の計算方法を変更した。しかし、お客に対して事前に十分な説明がなかったため、現場が混乱。不満の声があがっていた。Twitter上には、「店舗ではどうすることもできません。クレーム等は全てセブンイレブン本部までお願いします」（表記ママ）というPOPを撮影した画像が投稿されていた。
コーディング面接対策のために解きたいLeetCode 60問
自分がコーディング面接対策のために解いてよかった LeetCode の問題をコンセプトごとにまとめました。カバーするコンセプトは LinkedList Stack Heap, PriorityQueue HashMap Graph, BFS, DFS Tree, BT, BST Sort Dynamic Programming Binary search Recursion Sliding window Greedy + Backtracking です。 これらの問題が 30 分以内に実装できれば面接の準備は整ったと言っていいと思います。Easy と Medium で問題は構成されてます。進捗を管理するためにGoogle Spreadsheetを用意しました。コピペしてご自由にお使いください。 これらの問題は、LeetCode のリスト機能でも公開されています。クローンすれば自分がすでにど
MVVMやCleanArchitectureやDDDを採用しない理由 - IT業界で気づいたことをこっそり書くブログ
書き方が曖昧で合意が取れてないから 難しい割にメリットが薄いから 外部知識を入れるデメリットが大きいから 可読性が落ちるから 書けないiOSエンジニアが多く、学習コストも大きいから プロジェクトの進みが遅くなるから リードするチームが場当たり的チームだから 私のスタンスは、例えばCOBOLかJavaかというシーンで、市場にCOBOLエンジニアが多いならCOBOLを採用するし、時代がJavaに切り替わってるならJavaを採用するみたいな感じです。 Swiftなんかはバージョン4.1あたりでObjective-Cから完全移行しました。2.3では早かったですね（2.3から触ってました） 以下詳細。 書き方が曖昧で合意が取れていない問題 「◯◯は良いものだ」 「◯◯は難しくてよくわからない」 この2つの意見が並んでいる時、私は非常に警戒します。 現代のソフトウェア開発はチーム戦ですから、書き方にあ
『The BDD Books Discovery』はQAにも開発者にもPOにもPMにもとにかくみんなに薦めたい - テストウフ
BDD/ATDDを学ぶ上で最適な書籍『The BDD Books - Discovery』を翻訳して出版しました！ #bddbooks - ブロッコリーのブログ ありがたいことに推薦文を書く機会を頂いたので、出版より一足先に読ませていただきました。 私の推薦文は以下のように書いてます。 BDDについてなんとなく知っている、という方は必読です。 一段階深い理解と納得が得られるはずです。私がそうでした。 ビジネスと開発の協調について本書を読み、考え、そして実践することで、日々のソフトウェア開発をより良くできると思います。 推薦文には文字数の目安があったのでかなりさらっと書いてますが、もっと感想を言いたいのでこの記事を書いている次第です。 本はこちらから買えます。 BDD Books - Discovery… Gáspár Nagy 著 et al. [PDF/iPad/Kindle] （関係な
TIL: 冪等性、参照透過性、純粋関数 についてのメモ - かもメモ
勉強会で 読みやすいコードのガイドライン をやっていて冪等であるのがよい。と書かれていたのですが冪等についてふわふわした感覚だったので調べたメモ。 ⚠ しっかり調べた訳ではないので解釈が間違っている可能性があります :pray: 冪等性 idempotency, idempotence 同じ操作を何度繰り返しても、同じ結果が得られるという性質 f(x) = f(f(x)) が成立する (数学的な厳密な冪等性？) abs(-100) = abs(abs(-100)) なので abs() 関数は冪等性がある sqrt(16) === sqrt(sqrt(16)) は成立しないので sqrt() 関数は冪等性がない Math.random() は実行する度に得られる結果が異なるので冪等性はない 圧縮する zip を zip(zip(x)) とすると archive が二重になるので zip(x)
73. Value Object w/ kumagi | fukabori.fm
MP3ファイルをダウンロード 内容紹介 kumagi さんをゲストに、Value Object について語っていただいたエピソードです。 出演者 話したネタ Value Objectについて整理しよう Value Object とは何か？ Value Object で複数の値をくるむcompoundの具体例は？ Value Object のメリット・デメリットは？ 別名参照問題 Value Object は何でないか？ YAGNI原則 不変オブジェクト (Immutable Object) 書籍: リファクタリング 既存のコードを安全に改善する（第2版） マーチン・ファウラー氏のblog記事 - ValueObject Value Object Obsession と Primitive Obsession Primitive Obsession のメリットは？ Value Objectの
クソコードと認識することについて 〜ソースコードの解像度〜
プログラマなら、良いソースコードを書きたい。クソコードを書きたいプログラマは、居ないはず。 ソースコードを読んでクソコードと感じるのは、どうゆう時なんだろうか。 クソコードと感じる時 設計ミス(データベース設計/クラス設計)により本質的でない処理に、本当に実現したいことが埋もれてしまっている。 変数等の命名が適切でない、構造が適切でないために、意図が伝わりにくい。 自分のソースコード読解力、デザインパターンの知識が無いため、読めない。または読むのに苦労する。 クソコードと判断してしまう原因は、書き手の問題と読み手の問題が混じっていることもありそう。 コードの善し悪しを考える上で、「ソースコードの解像度」ってのが鍵になる気がしている。 熟練プログラマは、ソースコードを見る時の解像度が高いし、解像度の高いソースコードを書ける。 未熟なプログラマは、ソースコードから解像度の低い情報しか汲み取れな
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
Amazon.co.jp: ちょうぜつソフトウェア設計入門――PHPで理解するオブジェクト指向の活用: 田中ひさてる: Digital Ebook Purchas
The Book of CP-System
ポステルの法則