Document repositioning to-do lists

[jeremy]

You can reorder a to-do list within its to-do set. This documents the existing API endpoint for it.

What the docs now say

• Flat route: PUT /todosets/todolists/2/position.json with a top-level position (greater than or equal to one). A successful call returns 204 No Content.
• Position counts incomplete lists only. Completed lists are not counted, so a position of 1 moves the list above all other incomplete lists.
• The project-scoped route PUT /buckets/1/todosets/todolists/2/position.json remains available as a legacy form.

Documentation-only; no API changes.

---

Synced from bc3 doc/api/ by script/api/sync_to_bc3_api — not a hand-edit.

[Copilot]

Pull request overview

Documents the API endpoint for repositioning a to-do list within its to-do set, including the flat route semantics and the legacy project-scoped form.

Changes:

• Adds a new “Reposition a to-do list” endpoint section documenting PUT /todosets/todolists/:id/position.json and its 204 No Content behavior.
• Clarifies that position is 1-based and counts only incomplete to-do lists.
• Adds the legacy project-scoped route mapping to the new section.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7385114cbb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".