Skip to content

ドキュメント ​

ドキュメント行数 ​

documentation.doc_loc — 関数のドキュメントの行数。

項目内容
定義関数の直前にコメントのまとまりがある(デコレータ・属性の上でもよい。間に空行がなく、行末コメントではない)か、docstring のある言語で本体が docstring で始まるとき、その関数はドキュメントがあるとする。
スコープfunction
入力関数のドキュメントの範囲
計算方法ドキュメントがまたがる行数。ドキュメントがなければ 0。
単位lines
言語依存性部分的に言語に依存する
制約どのコメントの書き方でもよい(/** や /// に限らない)。
参考文献-

ドキュメントのある関数の数 ​

documentation.documented_function_count — ドキュメントのある関数の数。

項目内容
定義関数の直前にコメントのまとまりがある(デコレータ・属性の上でもよい。間に空行がなく、行末コメントではない)か、docstring のある言語で本体が docstring で始まるとき、その関数はドキュメントがあるとする。
スコープfile, project
入力関数のドキュメントの範囲
計算方法ドキュメントのある関数の数。プロジェクト:合計。
単位count
言語依存性部分的に言語に依存する
制約どのコメントの書き方でもよい(/** や /// に限らない)。
参考文献-

ドキュメント率 ​

documentation.documentation_ratio — ドキュメントのある関数の割合。

項目内容
定義ドキュメントのある関数の数 / 関数の数。
スコープfile, project
入力関数のドキュメントの範囲
計算方法関数がなければ not_applicable。
単位ratio
言語依存性部分的に言語に依存する
制約どのコメントの書き方でもよい(/** や /// に限らない)。
参考文献-