// Write or update user guide documentation for Trail-Sense tools. Use when asked to create, write, update, or modify a tool's user guide, help documentation, or user-facing documentation. Covers guide structure, formatting conventions, and common sections.
Add UI automation tests to Trail-Sense Android app using AutomationLibrary. Use when asked to create, add, write, or implement automated tests, UI tests, integration tests, or androidTests for Trail Sense tools. Covers test class structure, AutomationLibrary functions, and testing patterns.
Add groupable support to a Trail Sense feature or model. Use when asked to make an item groupable, add folders/groups, add group navigation, or retrofit an existing list using IGroupable/Groupable, GroupLoader, GroupListManager, group pickers, and Room parent/group persistence.
Audit translation accuracy for strings changed in a GitHub PR. Use when asked to check, review, audit, or verify translations in a pull request. Identifies inaccurate translated strings by comparing PR changes against the English source.
Add new Room database persistence to Trail-Sense Android app. Use when the user asks to create, add, or implement database persistence for a model, including Entity, DAO, Repository, and AppDatabase migration. Covers entity-to-model mapping, index configuration, and standard CRUD operations.
| name | trail-sense-user-guides |
| description | Write or update user guide documentation for Trail-Sense tools. Use when asked to create, write, update, or modify a tool's user guide, help documentation, or user-facing documentation. Covers guide structure, formatting conventions, and common sections. |
Write user guide documentation for Trail Sense tools.
guides/en-US/guide_tool_<toolname>.txt
The <toolname> should match the tool's directory name in app/src/main/java/com/kylecorry/trail_sense/tools/.
The [Tool Name] tool can be used to [brief description of purpose].
## Main Feature
Explanation of the main feature and how to use it.
## Creating a [item]
1. Tap the '+' button in the bottom-right corner of the screen.
2. Click '[option]'.
3. Enter [details].
4. Click the checkmark button in the top-right corner of the screen.
### Optional fields
- **Field name**: Description of the field.
- **Another field**: Description.
## Viewing a [item]
To view a [item], click it in the list. The following information will be shown:
- **Name**: The name of the item.
- **Detail**: Description.
## Delete a [item]
To delete a [item], click the menu button on the row you want to remove, then select 'Delete'.
## Quick action
You can enable the [Tool] quick action in the settings for the desired tab.
To use the quick action, tap the [Tool] quick action button to [action].
## Widgets
The following widgets can be placed on your device's homescreen or viewed in-app:
- **Widget name**: Description of what it shows.
## for main sections### for subsectionsFormat: Settings > Category > Setting name
Example: Settings > Weather > Storm alert
Reference other guides by name in single quotes.
Example: "See the 'Navigation' guide for more information."
Include sections as applicable to the tool:
| Section | When to Include |
|---|---|
| Main feature | Always - explain core functionality |
| Creating items | Tools that create/save data |
| Viewing items | Tools with detail views |
| Editing items | Tools with editable data |
| Deleting items | Tools with deletable data |
| Exporting | Tools that export data |
| Organizing (groups) | Tools with group/folder support |
| Searching | Tools with search functionality |
| Quick action | Tools with quick actions |
| Widgets | Tools with home screen widgets |
| Accuracy/Disclaimer | Tools making estimates or predictions |
## Creating a beacon
1. Tap the '+' button in the bottom-right corner of the screen.
2. Click 'Beacon'.
3. Enter a name for the beacon.
4. Enter a location for the beacon. You can tap the GPS icon next to the location field to use your current location.
5. Fill out any of the optional fields you want to record.
6. Click the checkmark button in the top-right corner of the screen.
You can adjust prediction sensitivity in Settings > Weather > Forecast sensitivity. Higher sensitivity may detect more patterns but might yield more false predictions.
## Quick action
You can enable the Weather Monitor quick action in the settings for the tab you want it on.
To use the quick action, tap the Weather Monitor quick action button to toggle it on or off.
## Accuracy
The weather prediction is a best guess using available sensor data and may not be accurate. If Trail Sense says it is going to be clear but you see what appears to be storm clouds rolling in, trust your instincts.
For existing guide examples, see:
guides/en-US/guide_tool_*.txt