Firmreader Docs Online logo

Content Best Practices

Write internal updates people actually read

The platform handles delivery — these conventions help your content land.

Write for skimmers

  • Lead with the takeaway in the first sentence.
  • Keep posts under 300 words; link out for detail.
  • Use headings and bullets so readers can scan.

Use priority levels honestly

PriorityUse forDelivery
HighTime-sensitive, action-requiredPush + email + in-app
NormalRegular announcementsIn-app + digest
LowFYI, optional readingIn-app only

If everything is High priority, nothing is. Most posts should be Normal.

Title formula

A good title answers "why should I care?" in under ten words.

WeakStrong
UpdateNew PTO policy starts July 1
ImportantOffice closed Friday for maintenance
Please readAction needed: confirm your benefits by Friday

Accessibility

  • Add alt text to every image.
  • Don't rely on color alone to convey meaning.
  • Spell out acronyms on first use for new hires.