Max: Updated to provide more context about this

2026-03-15T23:16:00Z

Updated to provide more context about this

← Older revision		Revision as of 19:16, 15 March 2026
Line 1:		Line 1:
	Leading with the most important ~~info~~ improves comprehension, helps the reader decide if they should keep reading~~, gives them what they're looking for immediately~~.		In technical writing, '''front-loading refers to leading with the most important information'''. This ensures that users can find what they need quickly and understand context before they act. Leading with the most important information improves comprehension and helps the reader decide if they should keep reading.

	~~BLUF (Bottom line~~ up ~~front) - military writing~~		Core models for documentation:
	* ~~Place~~ the ~~key information~~ at the ~~beginning~~ of ~~each section~~		* '''Inverted Pyramid:''' This model requires information is presented in descending order of importance with the most critical concepts, statements, and keywords at the top of a topic or paragraph. In journalism, this would include the 5 Ws immediately: who, what, when, where, and why, followed by supporting details, then the wrap-up.
			* '''Bottom Line Up Front (BLUF):''' This model focuses on placing the conclusion or required action at the top of a communication.
			* '''[[Context before action]]:''' At the sentence level, this model dictates conditions/contexts must be stated before the instruction.

	~~Inverted Pyramid~~ - ~~journalism~~		== Technical communication research shows... ==
	* ~~Most important points are delivered~~ at the ~~top of~~ the ~~story, followed by additional details~~		Research into cognitive psychology and technical communication provides reasons why this ordering is critical:<sup>1</sup>
	* ~~Include the 5 Ws immediately~~ - ~~who~~, ~~what~~, ~~when~~, ~~where why~~		* '''Scanning:''' Most users do not read documentation cover-to-cover; instead, they scan for relevant actions and keywords, and only stop to read carefully once they find something that matches their goal. Scannable text increases usability by 47%.
	* ~~The~~ how ~~provides supporting details~~		* '''Act-first instinct:''' People tend to act as soon as they see words describing an action. If the context/caution is placed at the end, users often perform the action before they reach that information.
	* Wrap up with background info		* '''Sense-making:''' When interacting with a new system, users both need to act to understand the program, but also need to understand the program before they can act. Because of this, they'll choose the "first reasonable action" rather than reading all of the instructions first.
			* '''Cognitive load and memory:''' Working memory is limited in how much information it can process simultaneously. Seeing high-level context first helps users build a mental model (schema) that reduces the mental effort required to process subsequent instruction.

	Links~~/references~~		== Links ==
	* [https://hawksem.com/blog/bluf-meaning/]		* [https://hawksem.com/blog/bluf-meaning/ What is BLUF? How to Use It to Improve Your Writing]
	* [https://www.masterclass.com/articles/how-to-write-articles-with-inverted-pyramid-structure]		* [https://www.masterclass.com/articles/how-to-write-articles-with-inverted-pyramid-structure How to Write the Best Articles With Inverted Pyramid Structure]

			== References ==
			<sup>1</sup> Dana E. Chisnell, [https://nvlpubs.nist.gov/nistpubs/Legacy/IR/nistir7519.pdf Style Guide for Voting System Documentation], August 2008, National Institute of Standards and Technology (NIST).

	----		----

	[[Category:Information & Tech]]		[[Category:Information & Tech]] [[Category:Technical Documentation]]

Max: added category

2026-03-10T20:30:41Z

added category

← Older revision		Revision as of 16:30, 10 March 2026
Line 13:		Line 13:
	* [https://hawksem.com/blog/bluf-meaning/]		* [https://hawksem.com/blog/bluf-meaning/]
	* [https://www.masterclass.com/articles/how-to-write-articles-with-inverted-pyramid-structure]		* [https://www.masterclass.com/articles/how-to-write-articles-with-inverted-pyramid-structure]

			----

			[[Category:Information & Tech]]

Max: Protected "Lead with the important details" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

2026-03-10T06:26:10Z

Protected "Lead with the important details" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

← Older revision	Revision as of 02:26, 10 March 2026
(No difference)

Max: moved from booknotes

2026-03-10T06:26:01Z

moved from booknotes

New page

Leading with the most important info improves comprehension, helps the reader decide if they should keep reading, gives them what they're looking for immediately.

BLUF (Bottom line up front) - military writing
* Place the key information at the beginning of each section

Inverted Pyramid - journalism
* Most important points are delivered at the top of the story, followed by additional details
* Include the 5 Ws immediately - who, what, when, where why
* The how provides supporting details
* Wrap up with background info

Links/references
* [https://hawksem.com/blog/bluf-meaning/]
* [https://www.masterclass.com/articles/how-to-write-articles-with-inverted-pyramid-structure]

Lead with the important details - Revision history

Max: Updated to provide more context about this

Max: added category

Max: Protected "Lead with the important details" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

Max: moved from booknotes