claude: Add a few small instructions based on experience with 1942

Author: gnprice

.claude/api.md

@@ -20,6 +20,8 @@ Each route binding follows a consistent pattern:
    }) {
    ```
 
+   The function name exactly matches the slug in the API docs URL, converted to camel case.
+
 2. **Doc comment** with a link to the Zulip API docs: `/// https://zulip.com/api/create-saved-snippet`
 
 3. **Calls `connection.get`/`.post`/`.patch`/`.delete`** with:
@@ -28,7 +30,7 @@ Each route binding follows a consistent pattern:
    - The URL path (relative to `/api/v1/`)
    - A `Map<String, dynamic>?` of parameters
 
-4. **Parameters are encoded** via `encodeParameters()`: values are JSON-encoded unless wrapped in `RawParameter(...)`, which passes the string through as-is. String parameters that shouldn't be double-quoted use `RawParameter`. Optional params are included conditionally with `if (x != null)`.
+4. **Parameter encoding**: values are automatically JSON-encoded (via `encodeParameters()`) unless wrapped in `RawParameter(...)`, which passes the string through as-is. String parameters that shouldn't be double-quoted use `RawParameter`. Optional params are included conditionally with `if (x != null)`.
 
 5. **Server version compat**: Use `connection.zulipFeatureLevel!` to check feature levels and adapt the request (e.g., different param names for old vs new servers). Mark these with `// TODO(server-N)` comments.
 

lib/widgets/action_sheet.dart

@@ -383,6 +383,9 @@ class DraggableScrollableModalBottomSheet extends StatelessWidget {
 /// (Even if we did live-update the buttons, it's possible anyway that a user's
 /// action can race with a change that's already been applied on the server,
 /// because it takes some time for the server to report changes to us.)
+//
+// When defining button classes (subclasses of this class), try to
+// put definitions in the same order as the buttons appear in the action sheet.
 abstract class ActionSheetMenuItemButton extends StatelessWidget {
   const ActionSheetMenuItemButton({super.key, required this.pageContext});