タグ

ブックマーク / qiita.com/yuya_sega (3)

  • 現場で必要になるswaggerの知識 - Qiita

    前回は「今日から始めるswagger入門」という最低限書けるようになっておいた方が良い物をこちらの記事で解説させてもらいました 今回は、筆者が4〜5年ほど現場で見てきたswaggerを元に、現場で必要になるswaggerの知識をまとめましたので、ぜひご覧になっていただけると嬉しいです! タグ付け pathsに書かれている各APIendpointをタグ付けしてグルーピングする目的で使用されます 現場では大量のAPIendpointを設計していくこととなるので、多くなってくると大変見辛くなってきます それをグルーピングすることにより見やすくしようということです openapi: 3.0.3 info: title: test-api version: 0.0.1 # ここから tags: - name: user description: ユーザー情報 # ここまで paths: /users

    現場で必要になるswaggerの知識 - Qiita
  • サラリーマンエンジニアの評価は単価なのか - Qiita

    まず言っておこう、間違いなく「否」であると思う 単価というのは一番定量的で評価基準として採用されやすいことは事実であると思う それ故に、単価≒給料だと思う人がいてもおかしくないですね ただ、質的に考えてみてほしい そもそも、単価が上がったから社内の評価があがったのであろうか? 単価ってなんなのか 単価ってどう上げるのか 単価が上がるとはどういうことなのだろうか 記事では評価の結果は給料のアップということと定義し、考えを始めようと思います 単価をあげるにはどうする必要があるのか 章は是非「自分が人を雇うとしたらどうか」、「自分がチームメンバーを評価するとしたらどうか」という視点も入れて読んでいただきたいです そもそも単価とは 準委任、SESの場合は簡単ですね お客様からいただく人月単価(1ヵ月働いた分の対価)がそれにあたります エンジニア単価とは、その業務に対するエンジニア1人の価格、

    サラリーマンエンジニアの評価は単価なのか - Qiita
  • インシデント共有方法に格の違いを感じ勝手に敗北感を味わった話 - Qiita

    私は普段、お客様のチームに入り込み、SEとして仕事をしております 今日はそのチームで実際に起こった出来事からなぜか勝手に敗北感を味わった話をしたいと思います まずなにがあったか 普段すでに番運用がされているシステムに新規要件を実装してまして、定期的に新機能をリリースするようなそんな運用となっています そんな中のある日、定例(朝会)の中で、直近リリースで発生したインシデントの共有がありました えーっと実は昨日〇〇という障害が番環境で発生してその対処をしてました 調べてみた結果、原因は〇〇さんのこのプルリクでして (私:おいおい個人名だすのか!! このファイルのこの行でNullチェックが漏れてました (私:わわわわ、公開処刑だぁぁぁ まぁたしかにこの辺はほげほげふがふがで (私:ふむふむさすがにフォロー入るかぁ でもテストやレビューでちゃんとカバーしときたかったですね (私:全員巻き込んで

    インシデント共有方法に格の違いを感じ勝手に敗北感を味わった話 - Qiita
  • 1