MDS029: conciseness-scoring

Paragraph conciseness score must not fall below a threshold.

# Settings

The score is produced by a pure-Go linear classifier with 15 features. The classifier outputs a risk score via sigmoid; the conciseness score is 1 - risk_score, so 1.0 = maximally concise. The min-score threshold is in conciseness space: paragraphs scoring below this value are flagged. The default 0.20 is intentionally conservative, catching only highly verbose paragraphs. Markdown tables are skipped.

# Config

Enable:

rules:
  conciseness-scoring: true

Enable with custom threshold:

rules:
  conciseness-scoring:
    min-score: 0.20
    min-words: 20

Disable:

rules:
  conciseness-scoring: false

# Examples

# Good

# Concise Paragraph

The release process validates links, updates version tags, and publishes
checksums so reviewers can verify artifacts before approving deployment.

# Bad

# Verbose Paragraph

Basically, it seems that we are just trying to explain the same idea in
order to make it very clear, and it appears that we are really adding very
little concrete information to the paragraph.

# Diagnostics

# Meta-Information

• ID: MDS029
• Name: conciseness-scoring
• Status: not-ready
• Default: disabled
• Fixable: no
• Implementation: source
• Category: prose