Skip to content

Commit

Permalink
Corporate bullshit overload
Browse files Browse the repository at this point in the history
  • Loading branch information
ker2x committed Jul 26, 2024
1 parent 9de9a72 commit 6b74cb4
Show file tree
Hide file tree
Showing 2 changed files with 57 additions and 0 deletions.
1 change: 1 addition & 0 deletions Writerside/d.tree
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@
<toc-element topic="SOMe-unnamed-software.md"/>
</toc-element>
<toc-element topic="AI-Things.md">
<toc-element topic="Cutting-Corporate-Bullshit.md"/>
<toc-element topic="Testing-Phi3.md"/>
<toc-element topic="Text-based-adventure-with-gemini.md"/>
<toc-element topic="Liar.md"/>
Expand Down
56 changes: 56 additions & 0 deletions Writerside/topics/Cutting-Corporate-Bullshit.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Cutting Corporate Bullshit from Corporate Documentation

Corporate documentation is often plagued with jargon, redundancy, and unnecessary complexity. Here are some strategies to streamline and clarify your documents:

## Identify and Eliminate Bullshit

* **Jargon:**
* Replace complex terms with simpler language.
* Define technical terms for clarity.
* Avoid using multiple synonyms for the same concept.
* **Redundancy:**
* Remove repeated information.
* Condense lengthy explanations.
* Eliminate unnecessary qualifiers (e.g., "very," "extremely").
* **Passive Voice:**
* Convert passive voice to active voice for clarity and conciseness.
* Example: "The report was written by the team" becomes "The team wrote the report."
* **Unnecessary Complexity:**
* Break down complex ideas into smaller, easier-to-understand points.
* Use bullet points or numbered lists to organize information.
* Avoid overly long sentences.

## Focus on Clarity and Conciseness

* **Write for Your Audience:**
* Tailor the language and level of detail to your reader's knowledge.
* Avoid assuming prior knowledge.
* **Use Strong Verbs:**
* Replace weak verbs with stronger ones for impact.
* Example: "Use" instead of "utilize."
* **Be Specific:**
* Provide concrete details and examples.
* Avoid vague or general statements.
* **Proofread Carefully:**
* Eliminate typos, grammatical errors, and inconsistencies.

## Practical Tips

* **Read Your Document Aloud:**
* This helps identify awkward phrasing and unnecessary complexity.
* **Use a Style Guide:**
* Consistent formatting and language improve readability.
* **Seek Feedback:**
* Ask colleagues to review your document for clarity and conciseness.

## Example: Before and After

**Before:**
> "The implementation of the new system will necessitate a comprehensive evaluation of existing processes to ensure optimal utilization of resources and alignment with strategic objectives."
**After:**
> "We'll need to assess current processes to make the new system work best and fit our goals."
By following these guidelines, you can create clear, concise, and effective corporate documentation that is easy to understand and act upon.

**Would you like to provide a specific example of corporate documentation you're working on? I can help you identify areas for improvement.**

0 comments on commit 6b74cb4

Please sign in to comment.