Screenshot conventions¶
Desk and CLI screenshots live in docs/assets/images/.
Adding images¶
- Save PNG or WebP files with descriptive names, e.g.:
desk-btu-configuration.pngdesk-btu-task-form.pngdesk-btu-task-schedule-cron.pngdesk-btu-task-log-detail.pngdesk-btu-run-later-list.pngcli-btu-py-config-show.png- Reference in markdown:
<figure class="btu-screenshot" markdown="span">

<figcaption>BTU Configuration — ping scheduler and email defaults</figcaption>
</figure>
- Run
mkdocs servelocally to verify layout.
Priority pages for screenshots¶
| Page | Suggested capture |
|---|---|
| Desk overview | BTU_Core workspace |
| BTU Configuration | Full form + ping button |
| BTU Task | Task form with function path |
| BTU Task Schedule | Cron + timezone fields |
| BTU Task Log | Log with stdout/stderr |
| BTU Run Later | List + document detail |
| Install scheduler | btu-py config show terminal |
Share screenshots in chat or commit directly to docs/assets/images/ — either works.
Logo¶
Place Datahenge or BTU logo files in docs/assets/:
logo.svg— header (light background); used when presentfavicon.png— browser tab icon (optional)
Until a BTU-specific mark exists, the Datahenge logo is fine. Update theme.logo in mkdocs.yml after adding files.