docs: Update conventions after snake_case migration.

Author: nedseb

CLAUDE.md

@@ -0,0 +1,70 @@
+# CLAUDE.md — Project Guidelines
+
+## Project Overview
+
+MicroPython driver library for the [STeaMi](https://www.steami.cc/) board. Each driver lives under `lib/<component>/` and follows a standard structure.
+
+## Driver Structure
+
+Each completed driver must contain:
+
+```
+lib/<component>/
+├── README.md
+├── manifest.py          # metadata() + package("<module_name>")
+├── <module_name>/
+│   ├── __init__.py      # exports main class
+│   ├── const.py         # register constants using micropython.const()
+│   └── device.py        # main driver class
+└── examples/            # English, plural — NOT "exemple" or "example"
+    └── *.py
+```
+
+## Coding Conventions
+
+- **Naming**: `snake_case` for all methods and variables. Enforced by ruff (N802, N803, N806).
+- **Constants**: use `from micropython import const` wrapper in `const.py` files.
+- **Imports**: `from <module>.const import *` is the project convention (F403/F405 ignored by ruff).
+- **Class inheritance**: `class Foo(object):` is the existing convention (Python 2 style, kept for consistency).
+- **Time**: use `from time import sleep_ms` (not `utime`, which is deprecated since MicroPython 1.19+).
+- **Exceptions**: use `except Exception:` instead of bare `except:` when possible.
+- **No debug prints** in production driver code. Enforced by ruff (T20, examples and tests excluded).
+
+## Driver API Conventions
+
+Each driver class must follow these conventions for consistency across the library:
+
+- **Constructor signature**: `def __init__(self, i2c, ..., address=DEFAULT_ADDR)` — first parameter is always `i2c` (not `bus`), address uses keyword argument with a default from `const.py`.
+- **Attributes**: `self.i2c` for the I2C bus, `self.address` for the device address (not `self.bus`, `self.addr`).
+- **I2C helpers**: use private snake_case methods `_read_reg()`, `_write_reg()` for register access.
+- **Time functions**: `from time import sleep_ms` — use `sleep_ms()` with integer milliseconds (not `sleep()` with float seconds, not `from utime import`).
+- **Constants**: always wrap register values with `micropython.const()` in `const.py` files.
+- **Class style**: `class DriverName(object):` (Python 2 compatible style, kept for MicroPython consistency).
+- **Exception handling**: `except Exception:` — never use bare `except:`.
+
+## Linting
+
+- Linter: **ruff** (config in `pyproject.toml`)
+- Line length: 99
+- Target: Python 3.7
+- Run: `ruff check` (CI runs this on PRs)
+- Key ignored rules: E722 (bare except), F401/F403/F405 (wildcard imports), E501 (line length)
+- Naming rules: N802 (function name), N803 (argument name), N806 (variable name)
+- No-print rule: T20 (examples and tests excluded)
+
+## Commit Messages
+
+Format enforced by CI: `<scope>: <Description starting with capital letter ending with .>`
+
+- Pattern: `^[^!]+: [A-Za-z]+.+ .+\.$`
+- Max length: 78 characters
+- Examples: `hts221: Fix missing self parameter in get_av method.`, `docs: Fix typos in README files.`
+
+## CI Checks
+
+- `.github/workflows/python-linter.yml` — runs `ruff check` on push/PR to main
+- `.github/workflows/check-commits.yml` — validates commit message format on PRs
+
+## Related Repositories
+
+- [steamicc/micropython-steami-tutorials](https://github.com/steamicc/micropython-steami-tutorials) — high-level display library (`steami_screen.py`, `steami_gc9a01.py`) that wraps the low-level drivers from this repo.

README.md

@@ -249,8 +249,8 @@ from apds9960 import APDS9960
 i2c = machine.I2C(1)
 apds = APDS9960(i2c)
 
-apds.enableLightSensor()
-light = apds.readAmbientLight()
+apds.enable_light_sensor()
+light = apds.read_ambient_light()
 
 ```
 
@@ -461,7 +461,7 @@ lib/<component>/
 ### Coding conventions
 
 - **Constants**: use `from micropython import const` wrapper in `const.py` files.
-- **Naming**: `snake_case` for new methods. Legacy `camelCase` is acceptable for I2C helpers to stay consistent with existing drivers.
+- **Naming**: `snake_case` for all methods and variables. Enforced by ruff (N802, N803, N806).
 - **Class inheritance**: `class Foo(object):` is the existing convention.
 - **Time**: use `from time import sleep_ms` (not `utime`, not `sleep()` with float seconds).
 - **Exceptions**: use `except Exception:` instead of bare `except:`.
@@ -471,7 +471,7 @@ lib/<component>/
 
 - **Constructor signature**: `def __init__(self, i2c, ..., address=DEFAULT_ADDR)` — first parameter is always `i2c` (not `bus`), address uses keyword argument with a default from `const.py`.
 - **Attributes**: `self.i2c` for the I2C bus, `self.address` for the device address (not `self.bus`, `self.addr`).
-- **I2C helpers**: use private snake_case methods `_read_reg()`, `_write_reg()` for register access. Legacy names (`setReg`, `getReg`, `i2cReadBytes`, etc.) are acceptable in existing drivers but new drivers must use the standard naming.
+- **I2C helpers**: use private snake_case methods `_read_reg()`, `_write_reg()` for register access.
 
 ### Linting