Skip to content

docs(connectors): describe Readwise Reader archive and restore - #696

Merged
aicayzer merged 1 commit into
mainfrom
docs/reader-archive
Oct 30, 2026
Merged

aicayzer merged 1 commit into
mainfrom
docs/reader-archive

Conversation

@aicayzer

Copy link
Copy Markdown
Contributor

Summary

The Readwise Reader page now says that Reader's archive and a Marfa item's archived state are the same thing, in both directions, which withmarfa/marfa-connectors#312 builds. Closes withmarfa/marfa-connectors#310

Changes

  • /catalog/connectors/readwise-reader: a new section, "Archive and restore", covers what an archive in Reader and an archive or restore in Marfa do, that highlights and saved pictures stay active, which side wins when both change in one run, how to tell a missing document from an archived one, and that many archives at once are not disappearances. READWISE_READER_INBOUND_ONLY is named as the switch for the part that goes back to Reader.

Testing

Notes for reviewers

  • Review depth: checks only, at the owner's request.
  • Readwise's documentation doesn't state what archiving does to highlights; its FAQ advises archiving annotated documents to preserve their highlights, so the page says Readwise keeps them.

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 marked this pull request as ready for review October 30, 2026 16:50
@aicayzer
aicayzer merged commit c0ac293 into main Oct 30, 2026
3 checks passed
@aicayzer
aicayzer deleted the docs/reader-archive branch October 30, 2026 16:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reader's archive maps to Marfa's archived state, both ways

1 participant