# BOGAMARK Best Practices

## Article Structure

1. **Categories** - Place at the very top of the article

   ```
   [[Category:Geography]]
   [[Category:Hawaii]]
   ```

2. **Table of Contents** - Use `<<TOC>>` marker where appropriate

3. **Content Sections** - Start with `## Overview` when it makes sense

## Table Formatting

- Use proper BOGAMARK table syntax with `||` delimiters
- Add styling attributes when they improve readability

## Link Formatting

### Internal Links

- Remove underscores from display text
- Good: `[[Banzai_Pipeline|Banzai Pipeline]]`
- Bad: `[[Pipeline_(surfing)|Pipeline_(surfing)]]`

### Link Everything Important

- Every key concept should link to its topic page
- Use descriptive display text

## List Formatting

### Proper Spacing

```
 * First item (note the space before *)
  * Nested item
 * Second item
```

## Section Hierarchy

- `##` Main sections
- `###` Subsections
- `####` Sub-subsections
- Never use `#` (reserved for article title)

## Topic Title Formatting

### URL vs Display Format

- **URLs**: Use lowercase with underscores (`machine_learning`, `apple_(company)`)
- **Display**: Use proper case with spaces (`Machine Learning`, `Apple (company)`)

- Correctly Formatted URL: `/t/artificial_intelligence`
- Correctly Formatted Display: `Artificial Intelligence`
- Correctly Formatted Link: `[[artificial_intelligence|Artificial Intelligence]]`

### Disambiguation

- Use parentheses for disambiguation: `Genesis (band)`, `Genesis (video game)`
- URL format: `genesis_(band)`, `genesis_(video_game)`
- Display format: `Genesis (band)`, `Genesis (video game)`

## Common Mistakes to Avoid

1. **Improper list indentation** - Use spaces before `*` or `1.`
2. **Markdown tables** - Never use markdown table syntax (`|---|---|`)
3. **Missing links** - Link important terms and concepts