# Clarification

`kaal:entity:clarification`

**Status.** derived

This node is assembled mechanically from the 2 claims that carry the concept tag `clarification`. It is a roster of what the corpus says under this term. It is **not** an adjudicated definition: no single statement here has been ruled canonical, and no first-appearance call has been made. Read the claims and judge for yourself.

## Every claim under this term

2 claims across 2 works, 2021 to 2024.

**2021**

- [3995709-014](https://wulfkaal.github.io/claims/3995709-014) [failure/argued] *(failure mode)* -- Increasing the number of reviewers who ask clarifying questions makes code simpler and clearer and thereby typically increases code quality, but hierarchical review processes make this impossible.
  > Moreover, the more people review the code with comments that ask for clarification, the more likely it becomes that the code becomes simpler and clearer, which in turn typically increases code quality. However, that is no possible in hierarchical review processes.
  Wulf A. Kaal, How DAOs Optimize Open-Source Code Reviews and Create Open-Source Standards (2021). SSRN: https://ssrn.com/abstract=3995709

**2024**

- [4734750-009](https://wulfkaal.github.io/claims/4734750-009) [mechanism/argued] -- Multiple reviewers asking clarifying questions tends to make code simpler and clearer and therefore higher quality, but hierarchical review processes structurally block this mechanism.
  > the more people review the code with comments that ask for clarification, the more likely it becomes that the code becomes simpler and clearer, which in turn typically increases code quality. However, that is not possible in hierarchical review processes.
  Wulf A. Kaal, Code Review DAO (2024). SSRN: https://ssrn.com/abstract=4734750

## Verify

Every claim above resolves to a record carrying a verbatim source quote, the sha256 of the source PDF, and a preformatted citation. Nothing here asks to be taken on trust.

    curl -s https://wulfkaal.github.io/entities/clarification.md | sha256sum

**Canonical form.** This markdown file is the canonical hashed representation of this entity node. Its sha256 is the content hash.
