https://github.com/colindean/problem-diagnosis-remedy-proposal

A clear, generally concise proposal format to win hearts and minds
https://github.com/colindean/problem-diagnosis-remedy-proposal

executive-summary proposal writing

Last synced: 6 days ago
JSON representation

A clear, generally concise proposal format to win hearts and minds

• Host: GitHub
• URL: https://github.com/colindean/problem-diagnosis-remedy-proposal
• Owner: colindean
• Created: 2018-02-13T15:48:50.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2022-10-04T16:38:33.000Z (over 2 years ago)
• Last Synced: 2025-01-20T16:22:12.511Z (22 days ago)
• Topics: executive-summary, proposal, writing
• Homepage:
• Size: 62.5 KB
• Stars: 10
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• my-awesome-github-stars - colindean/problem-diagnosis-remedy-proposal - A clear, generally concise proposal format to win hearts and minds (Others)

README

        
# Writing Proposals in "Problem, Diagnosis, Remedy" Style

"PDR style", as I call it, is a way of structuring a proposal that encourages the author to break the proposal summary into three short sections so that the summary is more easily digestable by executives and other decision makers.

I was introduced to this structure in 2009 or 2010 by Raul Valdes-Perez, who was CEO of [Vivísimo](https://en.wikipedia.org/wiki/Vivisimo) at the time. He preferred it and taught it to those who sought his official input on a matter. I took it a little further and include my full investigation, research, and recommendations in the document while maintaining the digestible summary.

Included in this repository is [Leslie Lamport](https://en.wikipedia.org/wiki/Leslie_Lamport)'s essay, _State the Problem Before Describing the Solution_, a seminal work in the computer science field. I discovered it 10+ years after formalizing this template and its recommendations are core to the workflow the template provides.

Also included in [`template-adr.md`](template-adr.md) is a barebones template for an [Architecture Decision Record](https://adr.github.io/) that includes the PDR format _inside of_ the [Nygard format for ADR](https://cognitect.com/blog/2011/11/15/documenting-architecture-decisions.html). I've used this template with great success more than a dozen times!

## Usage

You can fork this repository and make changes or you can simply copy the contents of template.md.

## License

Public domain / CC0.