僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳
2023 追記 2023 年現在では、以下の文章では採用を見送っている OpenAPI を使えば OK という雰囲気です。 Web APIの設計 作者:Arnaud Lauret翔泳社Amazon TL; DR ドキュメント生成にはkevinrenskers/raml2htmlを使った ドキュメントはRAML - RESTful API modeling languageで書いた RAMLにはJSON SchemaとJSONを記載できる APIで返ってくるJSONはRailsアプリのrequest specでJSON Schemaを使ってテストした JSON Schemaはr7kamura/json_worldで生成した ドキュメントに載せる例示のJSONもJSON Schemaからgin0606/screijiを使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
入社二ヶ月経ちました - 銀の人のメモ帳
前職を数ヶ月で辞めて転職活動して、意外にすんなりと転職活動を終えてた。普通に転職活動をしてみて、一社内定頂いたけど辞退した。 今働いてるところは、前回の転職活動で意識高いエントリを書いたらメールくれたベンチャー。 前回の転職活動では、力が欲し〜とか自分より凄い人が居るところで働きたい〜とか言ってたけど、今回は、如何に自分が楽しく働けるか、もしくは自分が楽しいように変えられるかを重視してた。 今の会社、社員数は20人に満たないから、わがままじゃなくて妥当性を持って変えようとすれば変わりそうな感じで、そこらへんについてはストレスが少ない。 本当は入社一ヶ月くらい経ったあたりで社名を明かしてそれなりにひと目に付くような文章書こうと思ってたけど、炎上の火消しにぶっっっこまれてマジで糞な感じになってるから、こんな感じで、なんか適当に書いてる。 僕より前に入社したエンジニアは、わりとギークっぽい感じで
エンジニアとして「頑張る」ということ - 銀の人のメモ帳
プロジェクトにアサインされた段階で、これはデスマになりそうだな、と感じることがある。 そういう時、僕は、プロジェクトを管理している人に「デスマは絶対にしない」ということと「残業もしない」という旨を伝えている。 これは、決して「頑張らない」という事ではなくて、スケジュールや予算の調整は、エンジニアより上のレイヤーの人間が「頑張る」べきことだと考えているから、そう言っている。 エンジニアとして僕が「頑張る」べきことは、例えば自分を含めたプロジェクトメンバーのスキルアップであったり、開発効率向上等によって工数を短縮出来ないかを考え、実行することであったり、プロジェクトで得たノウハウを次に活かせるような形で保存・共有することだと思っている。 実際は、様々な状況でデスマや残業をせざるを得ない事が多々ある。会社として頑張らなければならなかったり、金銭的なものであったり、色々な事情がある。 そうなったら
転職して三ヶ月経ったけど会社辞めたい - 銀の人のメモ帳
いやな気分よ、さようなら コンパクト版 作者:デビッド・D.バーンズ,David D. Burns星和書店Amazon 今日でだいたい入社三ヶ月と半分くらい。 辞めたさ自体は、入社一ヶ月の時点で有ったんだけど、転職活動で色んな人にお世話になったり迷惑かけた分、何かしら成果を上げてから退職しようと思ってた。 思ってたんだけど、最近いよいよもって辛くなってきたので、入社三ヶ月目に行われる人事面談で退職したい旨を伝えた。 予定では採用の時に担当してくれた人と、人事部の偉い人と、もう一人人事の人の四人でやる予定だったんだけど、当日行ってみたら採用担当してくれた人だけだった。なので退職したい旨は正式には伝えられていなくて、個人に対して意思を伝えた感じになってると思う。 退職したい理由は、「これ」と言える物がなくて、入社から今までの積み重ねで辞めたいと思っている。 何人かの人に話した結果、一言で言うと
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
