Skip to content

docs(connectors): describe v0.0.8 status words and core fields - #757

Merged
aicayzer merged 2 commits into
mainfrom
docs/connector-pages
Nov 1, 2026
Merged

aicayzer merged 2 commits into
mainfrom
docs/connector-pages

Conversation

@aicayzer

Copy link
Copy Markdown
Contributor

Summary

The connector pages now say what marfa-connectors v0.0.8 writes: status words for GitHub issues and pull requests and for Todoist tasks, core assignees on GitHub issues, core attendees on Google Calendar events, and Todoist's recurrence_text beside the core recurrence. The RSS, Readwise Reader and GitHub pages are rewritten under the 1,500-word connector limit, so their pending ceilings are gone.

Closes #707
Closes #711

Part of #705: the Todoist part is here, and the Task page's part is in #755. The guide's part comes with the Build and Run guides pull request.

Changes

  • GitHub (1,482 words, was 1,526): github.issue status words open, completed, canceled and duplicate; github.pull_request status draft, open, merged or closed, replacing the state and draft fields; assignees as core assignees entries named by login; a status with no GitHub word stays in Marfa, and an assignee with no name isn't sent. The "two processes" bullet is shortened.
  • Todoist (747 words): status is not_started or completed; the recurrence row is now recurrence_text, which still goes back to Todoist; the core recurrence holds RRULE lines when Todoist's words convert exactly, and is read only.
  • Google Calendar (977 words): core attendees beside guests, which keeps the flags attendees lacks; both read only.
  • RSS (1,472 words, was 2,637): rewritten whole. The entry fields are a list, the picture rules keep what an app or operator meets (what is fetched, the picture rows, rss_pictures, retries and limits, what happens when an entry leaves), and the fetch and feed limits link to the connector's README.
  • Readwise Reader (1,425 words, was 1,962): rewritten whole. The picture section keeps the setting, the rows, the manifest states and the run limits, and links to the README for the retry and repair conditions.
  • page-limits.json: the three rewrite pending ceilings are removed.

Testing

  • pnpm test: 770 passed, with the ceilings removed.
  • pnpm build and pnpm exec vite preview: the five pages and their .md copies render; RSS, Todoist and Google Calendar were looked at at 375 px with no sideways scroll.
  • Claims checked against marfa-connectors v0.0.8: each connector's README and type JSON (github.issue.json, github.pull_request.json, todoist.task.json, google.calendar.event.json, rss.entry.json, rss.picture.json), and the status words against core.task in the v0.0.50 catalog. The README anchors the pages link to exist on main.

Notes for reviewers

Checklist

  • The title is a scoped Conventional Commit.
  • New behavior has a test that was seen failing first, or no test was needed and the reason is above.
  • Docs, comments and the contract still say what is true after this change.

@aicayzer
aicayzer force-pushed the docs/connector-pages branch from 9d158a1 to aaf05f7 Compare November 1, 2026 00:03
@aicayzer
aicayzer merged commit b8ace8a into main Nov 1, 2026
8 checks passed
@aicayzer
aicayzer deleted the docs/connector-pages branch November 1, 2026 00:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant