Files Instruction (VALIDATED ◆)
: Use the syntax: "From the [Location], select [Object] then [Action]. This results in [Outcome]".
Example: "From the tab, select New then Blank Document . This launches a fresh workspace".
To produce a proper feature for "Files Instruction," you should focus on , logical hierarchy , and visual reinforcement . Whether you are writing a manual for users or configuring a codebase instruction file (like a .instructions.md or CLAUDE.md ), the goal is to reduce cognitive load. Core Writing Principles Files Instruction
Effective file instructions use a specific linguistic structure to help readers orient themselves before taking action:
: Use consistent phrasing for headings (e.g., "Creating a File," "Saving a File") to help users find information quickly. : Use the syntax: "From the [Location], select
: Start sentences with verbs (e.g., "Click," "Open," "Drag") to make instructions direct and actionable.
: Keep sentences short to avoid confusing the reader with multiple simultaneous tasks. Technical Formatting Features Good instructions are scannable and easy to navigate: This launches a fresh workspace"
: Apply bold formatting for UI elements (buttons, menus) that the user must interact with.