Skip to content

docs(notion): compare page at the current release in EN/RU/ES - #682

Merged
leemour merged 2 commits into
mainfrom
docs/notion-compare-0.5
Nov 17, 2026
Merged

leemour merged 2 commits into
mainfrom
docs/notion-compare-0.5

Conversation

@leemour

@leemour leemour commented Nov 17, 2026

Copy link
Copy Markdown
Member

Task

The public Notion comparison page still rated notion as of 0.2.0. Since then 0.3.0–0.5.0 added comments, file upload, page authors as people and better search hits. Owner approval: NEED-2727 A.

What the reader gets

The page opens with what the reader keeps and can do, names each tool once, gives the one prerequisite and a numbered contents list. The table and notes show what notion does now next to Notion MCP, ntn, notion-mcp-server and notion-exporter.

What

  • Opening (EN/RU/ES): gain first, then the limit; what the agent can answer; notion and memo each in one clause; the token as the one prerequisite; On this page list. The checked-on line drops the version number (AUTHORING: no release numbers in prose), unlike sibling compare pages.
  • New rows
    • A person's pages next to their chats and mail: notion ✅, Notion MCP 🟡 (creator filter, no join with other sources), others ❌.
    • Read comments and reply: notion ✅, Notion MCP ✅, ntn 🟡 (only ntn api), notion-mcp-server 🟡 (adds comments, no reply), notion-exporter ❌.
    • Add a file from the computer to a page: notion ✅, Notion MCP 🟡 (app sends the file, one part up to 20 MiB), ntn 🟡 (files create uploads, nothing attaches it), notion-mcp-server ❌, notion-exporter ❌.
  • Notes: search hits name notion and the profile; databases and the workspace root are out of search; authors join people by email (needs the connection's user-information capability with emails); an agent's relationship waits for confirmation; comments; files.
  • Stale claims removed: "no ready commands to write pages", and ntn as the pick for writing pages from Markdown.
  • "Notes on the marks" is now a ## heading; RU/ES anchor aliases moved next to their headings so contents links land on the section.

Evidence

  • notion-cli v0.5.0 CHANGELOG (0.3.0–0.5.0), src/knowledge.ts, src/sync/users.ts, src/commands/comments.ts, src/commands/files.ts; cli-memo 0.144.0 CHANGELOG (memo context files).
  • Rivals re-checked 17 Nov 2026: Notion MCP comments, files, search; ntn commands; notion-mcp-server scripts/notion-openapi.json at cf16e5c. Other rival cells unchanged.
  • A fresh agent reviewed the diff against notion-cli's code; its three findings are fixed in the second commit.

Not in this PR

Testing

  • pnpm sync, pnpm docs:contracts, pnpm docs:check (0 invalid examples), pnpm docs:spell on the three files, pnpm check:links --source.
  • RU wording grep: no hits.
  • next dev exited silently while compiling the docs route (three tries, turbopack and webpack), so the pages were not opened in a browser; anchors checked through the synced Markdown and the link check.

🤖 Generated with Claude Code

leemour and others added 2 commits November 18, 2026 00:13
- Opening rewritten to the reader's gain first, then what they get, the tools
  in one clause each and the one prerequisite, then a numbered contents list.
- New rows: a person's pages next to their chats and mail, reading and
  replying to comments, adding a file from the computer to a page.
- Rival cells for those rows re-checked on 17 November 2026 against Notion
  MCP's search, comments and files references, ntn's command reference and
  notion-mcp-server's OpenAPI spec at cf16e5c.
- Notes: search hits name notion and the profile, databases and the
  workspace root are out of search, authors join people by email, an agent's
  relationship waits for confirmation, comments and files.
- Stale claims removed: notion lacking write commands, ntn as the choice for
  writing pages from Markdown.
- "Notes on the marks" is a heading now; RU/ES anchor aliases sit next to
  their headings so the contents links land on the section.
- The checked-on line drops the version number (AUTHORING: no release
  numbers in prose).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…on by default

- notion-mcp-server's comment tool takes only a page parent, so the comments
  row is partly, not yes.
- Comments and file uploads are allowed by default and can be turned off;
  the opening no longer says they wait for permission.
- Without email access, authors are joined with no one (names may still be
  kept), as notion's sync warns.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@leemour
leemour merged commit d1596e9 into main Nov 17, 2026
2 checks passed
@leemour
leemour deleted the docs/notion-compare-0.5 branch November 17, 2026 23:16
leemour added a commit that referenced this pull request Nov 17, 2026
…683)

## Task
The Deploy after #681 failed in `pnpm check:links`:
`en/ru/es/docs/ydisk.html` and their `llms.mdx` copies link to
`/docs/ydisk/compare`, which the built site does not have (6 failures,
all this link). Every later deploy, including #682's, carries the same
failure.

## Why the page is not built
`scripts/localize.ts` builds site-owned pages
(`translations/pages/<tool>/compare.<lang>.md`) through
`siteOwnedFor(tool)` during `pnpm sync`, and sync runs only for tools in
`tools.json`. Notion is in `tools.json`; ydisk is not: it is a
hand-written page, `content/docs/ydisk.mdx`. So nothing reads
`translations/pages/ydisk/`.

## What
- The compare sentence and its link are removed from
`content/docs/ydisk.mdx`, `ydisk.ru.mdx` and `ydisk.es.mdx`.
- `translations/pages/ydisk/compare.*.md` and the `ydisk/compare` SEO
entries stay: the page publishes by itself once ydisk joins
`tools.json`.

## Not in this PR
Making ydisk a synced tool: a `tools.json` entry (package
`@wirecat/yandex-disk-cli`, not found on npm today), RU/ES translations
of its pages, and the overview moved to `translations/overviews/`. A
decision for the owner.

## Testing
- `pnpm check:links --source`, `pnpm docs:check` pass.
- A local `pnpm build` (needed for the full `pnpm check:links`) was
killed for lack of memory, so the deploy's own link check is the full
check.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
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.

1 participant