タグ

2019年7月21日のブックマーク (2件)

  • Javadoc ドキュメンテーションコメントの書き方 - Qiita

    出展: プログラム内のコメントの書き方 | 天才まくまくノート はじめに(モチベーション) こんな話があります。あるソフトウェア企業が一人の技術者の採用を決めました。その決め手となった理由は、「公開しているオープンソースソフトウェアのドキュメントが素晴らしかったから」です。彼らは、作成されたドキュメントを見ただけで、その人には技術力がある、一緒に働いて欲しいと判断したのです。 ある国の言語を学ぶために読み書きの練習が必要であるのと同様に、コーディング技術をつけるには、多くの良質なコードを読み、多くのコードを書くことが必要です。設計ドキュメントを書くのも同じことです。日頃から分かりやすいドキュメントを書く鍛錬を怠らず、長年の経験を積んでいかなければ、良質なドキュメントを書く力は身に付きません。今日からドキュメンテーションコメントをバリバリ書いて、ドキュメンテーション力を付けていきましょう。

    Javadoc ドキュメンテーションコメントの書き方 - Qiita
    r_jimano
    r_jimano 2019/07/21
    API 実装者のためのコメント(実装方法)と、API 使用者のためのコメント(使用方法)のどちらを書いているのか
  • OWASP Dependency-Check Maven Pluginで、依存ライブラリの脆弱性情報を確認する - CLOVER🍀

    これは、なにをしたくて書いたもの? OWASP Dependency-Check Maven Pluginという、依存ライブラリの脆弱性情報を確認できるプラグインがあるということを知りまして。 dependency-check-maven – Usage ちょっと、こちらを試してみようかなと。 OWASP Dependency-Check? OWASP Dependency-Checkというのは、プロジェクトの依存するコンポーネント(ライブラリ)の公開されている既知の脆弱性を 確認してくれるソフトウェアです。 OWASP Dependency Check - OWASP dependency-check – About 確認の結果、脆弱性が見つかった場合は該当するCVEのリストが表示されます。 https://cve.mitre.org/ ドキュメントによると、Java、.NETがサポート

    OWASP Dependency-Check Maven Pluginで、依存ライブラリの脆弱性情報を確認する - CLOVER🍀