folderweb/app/default/content/articles/2025-11-02-multi-file-content/04-best-practices.md

## Best Practices

### Use Descriptive Prefixes

Number your files with two-digit prefixes (`00-`, `01-`, `02-`) to maintain clear ordering:

- Allows up to 100 sections before needing three digits
- Keeps files sorted in file managers
- Makes reordering easy (just rename)

### Choose the Right Format

- **Markdown (`.md`)** - For most content. Simple, clean, readable.
- **HTML (`.html`)** - For complex layouts or embedded media.
- **PHP (`.php`)** - For dynamic content, calculations, or data display.

### Keep It Simple

Don't overcomplicate. If your page works well as a single file, keep it that way. Use multiple files when they genuinely make maintenance easier.

---

**This article itself demonstrates the multi-file approach.** View the source folder to see how it's structured!
Add multi-file page support and improve documentation Update README to explain multi-file page functionality Add example content files demonstrating the feature Improve folder type detection logic Implement new routing for page-type folders Add support for mixed content types in single pages Update navigation and metadata handling for multi-file pages Remove legacy frontpage.php in favor of multi-file approach Improve file-based routing documentation Add examples of different content types working together Update router to handle multi-file content rendering Implement proper sorting of content files Add best practices for multi-file content organization 2025-11-01 18:20:23 +01:00			`## Best Practices`

			`### Use Descriptive Prefixes`

			Number your files with two-digit prefixes (`00-`, `01-`, `02-`) to maintain clear ordering:

			`- Allows up to 100 sections before needing three digits`
			`- Keeps files sorted in file managers`
			`- Makes reordering easy (just rename)`

			`### Choose the Right Format`

			- Markdown (`.md`) - For most content. Simple, clean, readable.
			- HTML (`.html`) - For complex layouts or embedded media.
			- PHP (`.php`) - For dynamic content, calculations, or data display.

			`### Keep It Simple`

			`Don't overcomplicate. If your page works well as a single file, keep it that way. Use multiple files when they genuinely make maintenance easier.`

			`---`

			`This article itself demonstrates the multi-file approach. View the source folder to see how it's structured!`