はてなブックマーク

フューチャーアーキテクト Advent Calendar 2017の2日目です。 はじめに システム設計が大好きで大嫌いな皆さん、こんにちは。 突然ですが、皆さんはどのようにシステム設計における ドキュメント腐る問題 に立ち向かっていますか？ ドキュメント腐る問題とは、設計時に作成した各種ドキュメントがGoogle Driveやファイルサーバ上で陳腐化してしまい、現状の正しい状態を指していないことです。せっかく新規参画者がキャッチアップしようとしてもドキュメントが真実を示していないという怖いやつですよね。 解決策としては、各種ドキュメントを、MarkdownやAsciiDoc、UMLはPlantUMLやmermaid、ERDはPlantUMLやerd、画面遷移図はUI Flow、REST-API設計はSwaggerなど、なるべくテキストベースで管理し、GitHubなどのリポジトリで管理する

背景 内部システム向けにWebAPIを作ろうということになったが、一部のメンバーがRESTに嫌気が指していた。曰く、「（完全な）RESTに則るのは費用対効果に合わない。」 彼の発言を拡大解釈した結果、REST以外の思想に乗っ取りAPIを作りたいのだと思いを汲み取り、名前からしてパット見は全くRESTじゃなさそうなJSON-RPCというデータフォーマットの規格について調べた JSONのデータフォーマット JSONそれそのものの規格はRFC 7159で決まっていますが、それに則りその上でどういった要素にデータを格納していくべきかの設計は各人の好みが別れる所。 例えば、下記で言うとメタ情報はheader、データ部はbodyのリスト、リクエストIDはid、時刻はtimestamp、何かしら問題があればerrorといった、どういう名称の要素に、どういったkey-valueで格納するかなど実運用上、決

「それ○○で標準化されているよ」って指摘されることほど、エンジニアにとっての屈辱は無いですよね。 ということで、世間知らずだと思われないためにも、手始めにISO縛りで有益そうな標準規格1をまとめてみました。 ちなみに、ISOとは…？ 国際標準化機構（International Organization for Standardization）は国際規格を策定する世界最大のボランタリーな開発組織で、国家間に共通な標準を提供することによって、世界の貿易を促進することに貢献している という組織だそうです。 (どう考えてもIOSと略すべきだと思うのですが、ISOになった理由は諸説2あるようです。) コード体系 ISO 639 (言語名コード) 例: 日本語 = ja, jpn 朝鮮語 = ko, kor 中国語 = zh, zho, chi, zho ドイツ = de, deu, ger, deu

フューチャーアーキテクト Advent Calendar 2016の9日目1の記事です。 はじめに 技術書って良いですよね？オライリーとか○○実践入門の本とか。電子・紙問わず、積読がヤバくても、気になる新書はついポチっちゃう的な。自宅とオフィスに所狭しと並べられた技術書を見るとテンションが上がるというか。家族がいる人は、これ以上自宅に技術を持ち込まないで！って怒られたりとか。 そんな 愛する技術書、いざ自分で作れるとしたらどうしますか？ちょっとワクワクしませんか？ 今まで消費する側の人間だったのが生産する側に回って見て、裏側を知れるというか。その気になれば簡単に作れるものなので思い切って出版しちゃいませんか？ いやまぁ、色々言いましたが本音は、 ボクはお前らの書いた本を読みたい！ もっと色々な技術書を読ましてくれ！ という感じです。 いや、本当、実践テクでもポエムでも何でも読みたい。 技術

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

CSV Schemaとは 簡単に言うとCSVデータの定義とValidationを目的としたDSLです ほぼJSON SchemaのCSV版といってよさそうです 仕様はこちらをどうぞ CSVこれまで CSVはRFC4180 - 日本訳で標準化されてますが、策定が遅かったため各ベンダー間でデータ形式がバラバラです それによって特に困る領域の一つにEDI（データ交換）があります なにせ各システムが示すCSVが実際どのようなフォーマットなのか、認識を合わせするところから始まる必要があります （例）区切り文字が「カンマ」or「タブ」 か （例）囲み文字が「ダブルクォート」or「シングルクウォート」or「無し」 か （例）エスケープの有無 （例）ヘッダ行の有無 （例）項目中の改行や区切り文字はどういう仕様で扱うか etc. これがクリア出来た後に、実際のデータ項目のがどのような意味か（IDとか金額とか

はじめに GoogleさんがShellスタイルガイドを共有していたので、いくつか気になった点をピックアップしました。 自分のShellスタイルはかなり我流なので、自省の意味も込めてコメントも併記します。 Googleスタイルガイドの元ネタ （Python/C++/Java/Rとかだけでなくdocumentガイドなど色々あります） https://github.com/google/styleguide Shellスタイルガイド （今回はこちら） http://google.github.io/styleguide/shell.xml 本当は人間がチェックするのではなくcpplintのためXML定義なのかもですが、気にしない気にしない。 （見たところcpplintはc++だけだと思ってます） commitフックでshell系のlint走らせろっていうのが今風なのかもしれませんが、キニシナイキ

はじめに 数百万件程度のデータをPostgreSQLにて集計・分析する作業を通して得た知見をまとめました。 ギャップを感じたりハマった順番に並べていきますので、自然と徐々にレベルが上がるような構成になっています:) 内容はPostgreSQLとOracleとの比較になります。 どちらも触ってみて思いました。PostgreSQLもOracleもどちらも良い！(ｷﾘｯ 2022.07.02 会社の同僚の岡部さんがシェアしているのを見て、レイアウトが崩れていたりコメントを貰っていることに気が付きました。一部修正しています。 データ操作(DML) 1. from句なしでクエリが実行できる Oracleではfrom dualが必須ですね。 たったこれだけ書かなくて済むだけで非常に快適にクエリが書けます。

TL;DR wikiの効果や重要さはだれもが理解していると思います。 しかし、運用コストの高さから現実には放置されていることが多いのではないでしょうか？ そんな時はwiki拡張機能（WikiExtension）が効果的です。 読み手の利便性を高め、また発信側の編集へのモチベーションを高める効果があります。 正直メリットしかないと思うので、ぜひ導入しましょう！ WikiExtensionについてはこちら。 サマリ サイドバーの活用 フッタの活用 Sidebarでアクセスしやすくする WikiExtensionを適用しSidebarページを作るとサイドバーが有効になります Sidebarページは単純にWikiページの名前をSidebarにするだけです。 小文字大文字は無視するようです。 r-labsさんのページに有るように、「リンク集」、「アクセス数ランキング」、「更新履歴」、**「タグクラウ

関連して以下も参考にしてください [初めて地図周りの技術に触れた時に作ったまとめ資料 - Qiita] (http://qiita.com/laqiiz/items/7d256108920ff7afbf08) GoogleMapのオープンソース版地図アプリ（OSRM）のインストール - Qiita やりたい事 GoogleのGeocodingであったりYahoo!のジオコーダAPIを用いれば、住所の表記ゆれにも対応したよりスマートな緯度経度取得が可能ですが、利用数の制限や規約があるのが不便です。 もっと何度でも繰り返し自由に使える環境が欲しい！ということで本記事の内容となります。 「市区町村番地から緯度経度」ではなく、「緯度経度から市区町村番地」を取得する格好いいやり方は、masuidrive様の素晴らしく参考になる記事を参考下さい。 国土交通省のデータを使って、緯度経度から市区町村までを

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article? 関連して以下も参考にしてください GoogleMapのオープンソース版地図アプリ（OSRM）のインストール - Qiita 住所（市区町村番地）から緯度経度を取得する - Qiita まとめたこと やりたい事ベースでざっくり分類 住所（地名） ⇔ 緯度/経度変換 地図上への位置情報のプロット 距離計算・ルーティング（緯度経度計算、2点間の距離を計測） 詳しく 住所（地名） ⇔ 緯度/経度変換 住所（地名）→緯度/経度の変換はジオコーディング(Geocoding)と呼ばれる。 （昔はアドレスマッチングとも呼ばれていたらしい） 緯度/経度→

Mustacheとは Mustacheとはロジックレスのテンプレートエンジンで、その最大のウリはMustacheの記法を覚えると様々な言語で使えるから便利だよ―！ということみたいです。 特定の言語に依存しない記法になっているのは素晴らしいコンセプトで心惹かれます。 様々な言語… これらの言語で使えるようです（2015/06/20時点） {{ mustache }} Ruby, JavaScript, Python, Erlang, node.js, PHP, Perl, Perl6, Objective-C, Java, C#/.NET, Android, C++, Go, Lua, ooc, ActionScript, ColdFusion, Scala, Clojure, Fantom, CoffeeScript, D, Haskell, XQuery, ASP, Io, Dart,

Deleted articles cannot be recovered. Draft of this article would be also deleted. Are you sure you want to delete this article?