# Style Guide Template

Template for `.planning/sources/style-guide.md` — writing conventions for this paper.

**Purpose:** Document the stylistic conventions to follow. Ensures consistency and meets venue requirements.

---

## File Template

```markdown
# Style Guide

**Venue:** [Journal/Conference name]
**Style:** [APA 7th / Chicago / IEEE / Custom]
**Created:** [date]

## Formatting Requirements

### Document Format
- **Page limit:** [X pages / Y words]
- **Font:** [Times New Roman 12pt / etc.]
- **Margins:** [1 inch / 2.5 cm]
- **Line spacing:** [Single / Double]
- **Template:** [Link to venue template if applicable]

### Section Requirements
- Abstract: [word limit, structure requirements]
- Keywords: [number required, format]
- Headings: [numbering system, capitalization]
- Figures/Tables: [placement, caption format]
- References: [style, format]

## Citation Style

### In-Text Citations
- Single author: (Smith, 2023)
- Two authors: (Smith & Jones, 2023)
- Three+ authors: (Smith et al., 2023)
- Multiple citations: (Smith, 2023; Jones, 2024)
- Direct quote: (Smith, 2023, p. 45)

### Reference List
- Format: [APA / Chicago / IEEE / other]
- DOI: [Required / Preferred / Optional]
- URL format: [Full URL / Shortened / None]

## Writing Conventions

### Voice and Tense
- **Voice:** [Active preferred / Passive acceptable]
- **Person:** [First person plural "we" / Third person]
- **Tense:**
  - Introduction: [Present for established facts, past for prior work]
  - Methods: [Past tense for what was done]
  - Results: [Past tense for findings]
  - Discussion: [Present for interpretation, past for summary]

### Terminology
- Use: [Preferred terms for key concepts]
- Avoid: [Terms to avoid or define]
- Acronyms: [Define on first use, then use acronym]

### Numbers and Statistics
- Numbers: [Spell out one-nine, numerals for 10+]
- Statistics: [Format: F(2, 45) = 3.21, p < .05]
- Percentages: [45% / 45 percent]
- Decimals: [Two decimal places for most statistics]

## Discipline-Specific Conventions

### [Field-specific section]
- [Convention 1]
- [Convention 2]
- [Convention 3]

## Common Errors to Avoid

- [ ] Anthropomorphizing AI ("the model thinks...")
- [ ] Hedging excessively ("it might possibly suggest...")
- [ ] Passive voice overuse
- [ ] Run-on sentences
- [ ] Inconsistent terminology

## Checklist Before Submission

- [ ] Word/page count within limits
- [ ] All sections present per venue requirements
- [ ] Abstract meets word limit and structure
- [ ] Keywords in required format
- [ ] All citations in reference list
- [ ] All references cited in text
- [ ] Figures/tables numbered and captioned
- [ ] Formatting matches template
- [ ] Author information anonymized (if required)

---

*Style guide for: [Paper title]*
*Venue: [Journal/Conference]*
```

<guidelines>

**When to create:**
- At project initialization
- After confirming target venue
- Before any significant writing

**Key sections:**
- Formatting: Page limits, fonts, margins
- Citations: How to cite, reference format
- Writing: Voice, tense, terminology
- Discipline: Field-specific conventions

**Sources for guidelines:**
- Venue author guidelines
- Style manual (APA, Chicago, etc.)
- Example papers from venue
- Editor/reviewer feedback on prior submissions

**Common venue variations:**
- Some require structured abstracts
- Some allow/disallow first person
- Page limits vs word limits
- Supplementary materials policies
</guidelines>

<example>
```markdown
# Style Guide

**Venue:** CHI 2025
**Style:** ACM / APA-like
**Created:** 2025-01-10

## Formatting Requirements

### Document Format
- **Page limit:** 10 pages (excluding references)
- **Font:** Use ACM template (default fonts)
- **Margins:** Per ACM template
- **Line spacing:** Per ACM template
- **Template:** [ACM CHI 2025 template](https://chi2025.acm.org/authors/)

### Section Requirements
- Abstract: 150 words max, single paragraph
- Keywords: 3-5 keywords, lowercase, semicolon-separated
- Headings: Numbered (1., 1.1, 1.1.1), sentence case
- Figures/Tables: Float to top/bottom, caption below figures, above tables
- References: ACM reference format

## Citation Style

### In-Text Citations
- Single author: Smith [23]
- Two authors: Smith and Jones [23]
- Three+ authors: Smith et al. [23]
- Multiple citations: [23, 45, 67]
- Direct quote: [23, p. 45]

### Reference List
- Format: ACM reference format
- DOI: Required when available
- URL format: Include access date

## Writing Conventions

### Voice and Tense
- **Voice:** Active preferred
- **Person:** First person plural "we"
- **Tense:**
  - Introduction: Present for facts, past for prior work
  - Methods: Past tense
  - Results: Past tense
  - Discussion: Present for interpretation

### Terminology
- Use: "participants" not "subjects"
- Use: "AI-assisted" not "AI-generated"
- Avoid: "users" when meaning "participants"
- Acronyms: Define on first use (e.g., "artificial intelligence (AI)")

## Checklist Before Submission

- [ ] 10 pages or fewer (excluding refs)
- [ ] Abstract ≤ 150 words
- [ ] 3-5 keywords
- [ ] All figures/tables referenced in text
- [ ] Accessibility: Alt text for figures
- [ ] Anonymized for review

---

*Style guide for: AI-Assisted Writing Framework*
*Venue: CHI 2025*
```
</example>