Skip to content

Instantly share code, notes, and snippets.

@danielmiessler
Created March 25, 2024 18:48
Show Gist options
  • Select an option

  • Save danielmiessler/370321812091ea497463824bc43eee2f to your computer and use it in GitHub Desktop.

Select an option

Save danielmiessler/370321812091ea497463824bc43eee2f to your computer and use it in GitHub Desktop.
analyze_pinker_prose Result

Prose analysis of https://danielmiessler.com/p/efficient-security-principle

STYLE ANALYSIS

  • The prose is written in a mix of Classic and Practical styles.
  • It aims for clarity and directness while efficiently conveying information.
  • The conversational tone addresses the reader directly, a hallmark of Classic style.
  • Some technical jargon is used, leaning towards the Practical style at times.
  • Overall, the style choices are appropriate for the informative nature of the piece.

POSITIVE ASSESSMENT

  • Clarity: 8/10 - The intended message is quite clear throughout.
  • Brevity: 7/10 - Generally concise, though some points could be more succinct.
  • Coherence: 8/10 - Well-organized with good logical flow between ideas.
  • Directness: 9/10 - Straightforward communication of the key points.
  • Precision: 8/10 - Word choices accurately convey intended meanings.

CRITICAL ASSESSMENT

  • Metadiscourse: 4/10 - Some instances of "talking about the talk" (e.g. "I'd like to propose...").
  • Jargon and Technical Terms: 7/10 - Mostly avoids jargon, but some security-specific terms used.
  • False Fronts: 8/10 - Largely avoids unnecessarily complex words or academic-sounding phrases.
  • Zombie Nouns: 6/10 - Some nominalizations present (e.g. "recommendation", "improvement").
  • Redundancy: 8/10 - Mostly avoids repeating information unnecessarily.

EXAMPLES

Good Writing:

  • "The security baseline of an offering or system faces continuous downward pressure from customer excitement about, or reliance on, the offering in question." - Clear, direct statement of a key point.
  • "If people in general know the risk and they're still taking it, that's just because they value the offering that much." - Concise, conversational explanation.

Needs Improvement:

  • "Passionate security experts struggling with low security baselines should absorb this truthso their mental health and job satisfaction don't suffer unnecessarily." - Somewhat wordy; could be more concise.
  • "There is a natural, glacial upgrade of all security just generally as a result of technicalimprovement, and within companies that are working on it diligently." - Long, complex sentence; could be broken up for clarity.

SPELLING/GRAMMAR

  • No significant spelling or grammar errors found.

IMPROVEMENT RECOMMENDATIONS

  • Reduce instances of metadiscourse to maintain focus on the core ideas.
  • Break up a few of the longer, more complex sentences for improved readability.
  • Replace some nominalizations with active verbs for more engaging prose.
  • Provide a clear, concise definition of "Efficient Security Principle" early on.
  • Consider reducing or explaining some of the more technical security terms.

SCORING

STARTING SCORE = 100

Deductions:

  • -5 for some instances of metadiscourse
  • -5 for a few overly complex sentences
  • -5 for occasional use of nominalizations

FINAL SCORE = 85

Overall, the prose is clear, well-organized, and effectively conveys its key ideas. With some minor adjustments to further enhance concision and limit jargon, it could be an even str

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment