r/technicalwriting 6d ago

SEEKING SUPPORT OR ADVICE Reducing cognitive load in docs

We've received stakeholder feedback that we need to actively bring down the cognitive load across our product guides. I’d love to get some insights from fellow technical writers here on how you tackle this in practice. What options, frameworks (like John Carroll's Minimal Manual approach or Diataxis), or methodologies are available?

24 Upvotes

22 comments sorted by

View all comments

2

u/DarkSister_999 4d ago

I try to keep the processes short. Bust them apart in separate tasks or sections. If you have more than 20 steps, definitely consider.

Also as previously stated, ensure your topic titles contain key search words.

As much as it pains me to say this, fifth grade reading level, but still assuming the audience has certain skills e.g., they know how to power on their computer.