How to write internal documentation that works - Deepstash
De-escalate Office Tension

Learn more about communication with this collection

How to create a positive work environment

Conflict resolution strategies

Effective communication in the workplace

De-escalate Office Tension

Discover 87 similar ideas in

It takes just

12 mins to read

Creating internal documentation

Creating internal documentation

When creating documentation, you're not speaking to people with institutional knowledge.

You're speaking either to people who sit outside your team and aren't privy to your department's lingo, or to the newbies who don't yet know their CRMs from their CMSs. 

2

86 reads

Don't get bogged down by the details

For overarching processes, it's better to whittle down the writing to a digestible format, with enough detail for it to be comprehensible, but not so in-depth that any tiny change in the process would make the whole lot moot. 

If your internal docs are so convoluted that you break down every single process and concept within that process in agonizing detail, you and your readers are in for a rough time. You're also going to have a field day when something inevitably changes and you need to update your docs to match. 

3

52 reads

Keep your processes straightforward

If the process is complicated, the documentation will be too. If you can't explain something in straightforward terms, you should correct the process until you can.

Your processes—and the documents explaining them—should aim for what helps the most people, not what helps a few people the most. 

4

51 reads

Replace jargon with plain language

Whether it's training materials, employee handbooks, or standard operating procedures, laying out everything in a non-daunting way can bring new team members up to speed faster.

Steven Pinker describes this phenomenon as "the curse of knowledge." He coined the term to describe what happens when experts overestimate the knowledge level of non-experts. We tend to assume too much knowledge, don't provide enough context, and fail to define abbreviations or jargon we take for granted. 

3

41 reads

Include broader context about each team

Having a strong company culture isn't something you can just declare. It takes deliberate action to bring people together and to make every department accessible. 

So: how do clear communications better company culture? For one thing, internal documents are a great way to establish the company in terms of character and style for employees. If employees feel like they're a part of something that they know and understand, they'll perform better. 

3

35 reads

CURATED BY

saisha

Sharing is caring

stash-superman-illustration

Explore the World’s

Best Ideas

200,000+ ideas on pretty much any topic. Created by the smartest people around & well-organized so you can explore at will.

An Idea for Everything

Explore the biggest library of insights. And we've infused it with powerful filtering tools so you can easily find what you need.

Knowledge Library

Powerful Saving & Organizational Tools

Save ideas for later reading, for personalized stashes, or for remembering it later.

# Personal Growth

Take Your Ideas

Anywhere

Organize your ideas & listen on the go. And with Pro, there are no limits.

Listen on the go

Just press play and we take care of the words.

Never worry about spotty connections

No Internet access? No problem. Within the mobile app, all your ideas are available, even when offline.

Get Organized with Stashes

Ideas for your next work project? Quotes that inspire you? Put them in the right place so you never lose them.

Join

2 Million Stashers

4.8

5,740 Reviews

App Store

4.7

72,690 Reviews

Google Play

samz905

Don’t look further if you love learning new things. A refreshing concept that provides quick ideas for busy thought leaders.

Shankul Varada

Best app ever! You heard it right. This app has helped me get back on my quest to get things done while equipping myself with knowledge everyday.

Ashley Anthony

This app is LOADED with RELEVANT, HELPFUL, AND EDUCATIONAL material. It is creatively intellectual, yet minimal enough to not overstimulate and create a learning block. I am exceptionally impressed with this app!

Sean Green

Great interesting short snippets of informative articles. Highly recommended to anyone who loves information and lacks patience.

Laetitia Berton

I have only been using it for a few days now, but I have found answers to questions I had never consciously formulated, or to problems I face everyday at work or at home. I wish I had found this earlier, highly recommended!

Jamyson Haug

Great for quick bits of information and interesting ideas around whatever topics you are interested in. Visually, it looks great as well.

Giovanna Scalzone

Brilliant. It feels fresh and encouraging. So many interesting pieces of information that are just enough to absorb and apply. So happy I found this.

Ghazala Begum

Even five minutes a day will improve your thinking. I've come across new ideas and learnt to improve existing ways to become more motivated, confident and happier.

Read & Learn

20x Faster

without
deepstash

with
deepstash

with

deepstash

Access to 200,000+ ideas

Access to the mobile app

Unlimited idea saving & library

Unlimited history

Unlimited listening to ideas

Downloading & offline access

Personalized recommendations

Supercharge your mind with one idea per day

Enter your email and spend 1 minute every day to learn something new.

Email

I agree to receive email updates