Recipe Style Guide: Difference between revisions

From Burleson Family Wiki
(Created page with "Our Recipe Style Guide General Format • Use a consistent layout with clear section headings. • Title in ALL CAPS or Title Case, underlined with =. • Subheadings underlined with -. • Ingredients as a bulleted list (-). • Instructions as a numbered list (1., 2., etc.). • Use a single blank line between list items. • Use a double blank line between major sections. • Keep lines within 72–80 characters for readability. • Use left alignment with m...")
 
No edit summary
Line 1: Line 1:
Our Recipe Style Guide
=Our Recipe Style Guide=


General Format
==General Format==
Use a consistent layout with clear section headings.
* Use a consistent layout with clear section headings.
Title in ALL CAPS or Title Case, underlined with =.
* Title in ALL CAPS or Title Case, underlined with =.
Subheadings underlined with -.
* Subheadings underlined with -.
Ingredients as a bulleted list (-).
* Ingredients as a bulleted list (-).
Instructions as a numbered list (1., 2., etc.).
* Instructions as a numbered list (1., 2., etc.).
Use a single blank line between list items.
* Use a single blank line between list items.
Use a double blank line between major sections.
* Use a double blank line between major sections.
Keep lines within 72–80 characters for readability.
* Keep lines within 72–80 characters for readability.
Use left alignment with minimal indentation.
* Use left alignment with minimal indentation.


Section Order
==Section Order==
1. Recipe Title
# Recipe Title
2. Servings, Prep Time, Cook Time (inline)
# Servings, Prep Time, Cook Time (inline)
3. Ingredients
# Ingredients
4. Instructions
# Instructions
5. Optional Sections: Notes, Variations, Make Ahead, Storage, Tags
# Optional Sections: Notes, Variations, Make Ahead, Storage, Tags


Measurement Abbreviations
==Measurement Abbreviations==


Use these standard abbreviations (lowercase):
Use these standard abbreviations (lowercase):
tsp = teaspoon
* tsp = teaspoon
tbsp = tablespoon
* tbsp = tablespoon
oz = ounce(s)
* oz = ounce(s)
lb = pound(s)
* lb = pound(s)
g = gram(s)
* g = gram(s)
kg = kilogram(s)
* kg = kilogram(s)
ml = milliliter(s)
* ml = milliliter(s)
l = liter(s)
* l = liter(s)
c = cup(s)
* c = cup(s)
pkg = package
* pkg = package
pt = pint
* pt = pint
qt = quart
* qt = quart


Measurement Formatting
==Measurement Formatting==
Use fractions (e.g., 1/2, 3/4) instead of decimals when practical.
* Use fractions (e.g., 1/2, 3/4) instead of decimals when practical.
Write quantity first, then unit, then ingredient (e.g., 1 c flour).
* Write quantity first, then unit, then ingredient (e.g., 1 c flour).
Use lowercase units with no periods (e.g., tbsp, not Tbsp.).
* Use lowercase units with no periods (e.g., tbsp, not Tbsp.).
Describe ingredient preparation after the name (e.g., onion, diced).
* Describe ingredient preparation after the name (e.g., onion, diced).
Optional ingredients or notes can appear in parentheses.
* Optional ingredients or notes can appear in parentheses.


Language and Phrasing
==Language and Phrasing==
Use imperative mood in instructions: Add, Mix, Simmer, etc.
* Use imperative mood in instructions: Add, Mix, Simmer, etc.
Avoid vague terms like some or a pinch unless contextually appropriate.
* Avoid vague terms like some or a pinch unless contextually appropriate.
Be consistent with ingredient names (e.g., always use bell pepper).
* Be consistent with ingredient names (e.g., always use bell pepper).
Keep language concise and precise.
* Keep language concise and precise.


Optional Sections
==Optional Sections==
Notes – substitutions, tips, or clarifications
* Notes – substitutions, tips, or clarifications
Variations – optional changes or regional styles
* Variations – optional changes or regional styles
Make Ahead – prep steps that can be done in advance
* Make Ahead – prep steps that can be done in advance
Storage – how to store the finished dish
* Storage – how to store the finished dish
Nutrition – only if accurate and brief
* Nutrition – only if accurate and brief
Tags – dietary/category labels (e.g., vegan, gluten-free, spicy)
* Tags – dietary/category labels (e.g., vegan, gluten-free, spicy)


Formatting Summary
==Formatting Summary==
Title: uppercase or title case, underlined with =
* Title: uppercase or title case, underlined with =
Headings: underlined with -
* Headings: underlined with -
Bullets: - for ingredients
* Bullets: - for ingredients
Numbers: 1., 2., etc. for instructions
* Numbers: 1., 2., etc. for instructions
Spacing: blank line between items, double between sections
* Spacing: blank line between items, double between sections
Line width: 72–80 characters max
* Line width: 72–80 characters max

Revision as of 15:37, 26 May 2025

Our Recipe Style Guide

General Format

  • Use a consistent layout with clear section headings.
  • Title in ALL CAPS or Title Case, underlined with =.
  • Subheadings underlined with -.
  • Ingredients as a bulleted list (-).
  • Instructions as a numbered list (1., 2., etc.).
  • Use a single blank line between list items.
  • Use a double blank line between major sections.
  • Keep lines within 72–80 characters for readability.
  • Use left alignment with minimal indentation.

Section Order

  1. Recipe Title
  2. Servings, Prep Time, Cook Time (inline)
  3. Ingredients
  4. Instructions
  5. Optional Sections: Notes, Variations, Make Ahead, Storage, Tags

Measurement Abbreviations

Use these standard abbreviations (lowercase):

  • tsp = teaspoon
  • tbsp = tablespoon
  • oz = ounce(s)
  • lb = pound(s)
  • g = gram(s)
  • kg = kilogram(s)
  • ml = milliliter(s)
  • l = liter(s)
  • c = cup(s)
  • pkg = package
  • pt = pint
  • qt = quart

Measurement Formatting

  • Use fractions (e.g., 1/2, 3/4) instead of decimals when practical.
  • Write quantity first, then unit, then ingredient (e.g., 1 c flour).
  • Use lowercase units with no periods (e.g., tbsp, not Tbsp.).
  • Describe ingredient preparation after the name (e.g., onion, diced).
  • Optional ingredients or notes can appear in parentheses.

Language and Phrasing

  • Use imperative mood in instructions: Add, Mix, Simmer, etc.
  • Avoid vague terms like some or a pinch unless contextually appropriate.
  • Be consistent with ingredient names (e.g., always use bell pepper).
  • Keep language concise and precise.

Optional Sections

  • Notes – substitutions, tips, or clarifications
  • Variations – optional changes or regional styles
  • Make Ahead – prep steps that can be done in advance
  • Storage – how to store the finished dish
  • Nutrition – only if accurate and brief
  • Tags – dietary/category labels (e.g., vegan, gluten-free, spicy)

Formatting Summary

  • Title: uppercase or title case, underlined with =
  • Headings: underlined with -
  • Bullets: - for ingredients
  • Numbers: 1., 2., etc. for instructions
  • Spacing: blank line between items, double between sections
  • Line width: 72–80 characters max