Hacker News new | ask | show | jobs
by runevault 1284 days ago
An option if you don't wanna write the main document as a pyramid is to write a brief version as an email/DM/What have you but include a link saying for anyone who wants the in depth version it is available for you to read. That way you can structure the document in the way people who expressly want it will find it useful (which might still be pyramid but you aren't constrained to it) while giving the original person what they might need in the shorter form.
1 comments

This is where a short abstract or executive summary upfront can make all the difference. If the main points are summarized, they will (hopefully) be read; the rest of the document, no matter the format, can then be read for context or with references from summary.