artwo.xyz
1# Commit Scopes for Webette
2
3This document defines the official commit scopes used throughout the Webette project.
4Use them together with the conventional commit format:
5
6```
7<type>(<scope>): <short description>
8```
9
10---
11
12## Core Scopes
13
14These correspond to Webette’s main systems and will cover most commits:
15
16- **core** — Main engine logic (parsing, AST handling, rendering pipeline).
17- **cli** — Commands, flags, build/serve actions, log output.
18- **config** — Site configuration handling and tool-level config.
19- **collections** — Logic for content collections, sorting, indexing.
20- **templates** — Templating engine, layouts, partials, template resolution.
21- **plugins** — Plugin system, hooks, plugin API.
22- **renderer** — HTML generation, block processing, rendering steps.
23- **fs** — Filesystem operations, reading/writing, watch mode.
24- **logs** — Logging system, translations, future UI integration.
25- **site** — Output structure and final site generation.
26
27---
28
29## Secondary Scopes
30
31Useful for supporting parts of the project:
32
33- **docs** — Documentation updates.
34- **deps** — Dependency additions, removals, and updates.
35- **tests** — Unit tests and integration tests.
36- **ci** — Continuous integration setups and workflows.
37- **build** — Build scripts for Webette itself.
38
39---
40
41## Optional Scopes
42
43Use these if/when the related modules exist:
44
45- **ui** — The future interface for running build/serve.
46- **examples** — Example sites or starter templates.
47- **themes** — Theme system and theme management.
48- **utils** — Shared utility functions.
49
50---
51
52## Examples
53
54```
55feat(core): add collection scanning with numeric ordering
56refactor(renderer): simplify block resolution flow
57fix(fs): handle missing index.md in nested folders
58feat(plugins): implement onLoad and onRender hooks
59docs(glossary): update terminology
60chore(config): add environment config file support
61build(ci): add Bun watch mode to serve command
62```