Skip to content

Search visibility: /extension/ rewrite, /alternatives/, highlight-without-spans guide, question H2s, npm keywords - #60

Merged
marcellosso merged 1 commit into
mainfrom
feat/search-visibility-59
Oct 31, 2026
Merged

marcellosso merged 1 commit into
mainfrom
feat/search-visibility-59

Conversation

@marcellosso

Copy link
Copy Markdown
Owner

Closes #59

Summary

 apps/docs/src/content/docs/
+├── alternatives.mdx                 # /alternatives/: extension vs Weava, Glasp, Liner, Diigo, Memex, Hypothesis, Web Highlights (FAQPage)
 ├── compare.mdx                      # + links to /alternatives/
 ├── faq.mdx                          # + 4 honest extension questions (URL changes, sync, PDF, Markdown)
 ├── extension/index.mdx              # definition first sentence + question H2s
 ├── extension/privacy.mdx            # definition + question H2s (policy unchanged)
 ├── guides/anchoring.mdx             # definition + persist / serialize Range / text changes / URL changes
+├── guides/highlight-without-spans.mdx  # vanilla CSS Custom Highlight API guide (TechArticle)
 ├── recipes/react.mdx                # spans, mark.js re-render, Next.js App Router example
 └── recipes/rest-storage.mdx         # "How do I save user highlights to my own database?"
 apps/docs/src/
+├── alternatives.ts                  # Q&A data shared by the page and its FAQPage JSON-LD
+├── components/FaqList.astro         # renders FAQ data (faq + alternatives)
+├── components/Footer.astro          # quiet docs footer: Compare · Alternatives · FAQ
 └── components/Head.astro            # FAQPage for /faq/ and /alternatives/
 packages/penciled/package.json       # + text-annotation, web-highlighter, react-highlight, nextjs, custom-highlight-api
 README.md, packages/penciled/README.md  # Medium-style line + FAQ synced with faq.ts
 .changeset/search-visibility.md      # patch

The competitor prices and limits on /alternatives/ come only from the vendors' own pages, checked on 31 October 2026, and each one cites its link. Cells I couldn't verify say "see vendor":

Vendor Verified on vendor page Left as "see vendor"
Weava Free: unlimited highlights/notes, 100 MB, unlimited devices Premium price (page shows both $3.99 and $7.99/month)
Glasp Free: unlimited public highlights, public by default; Pro $12.50/mo billed yearly ($150/yr) —
Liner Free $0; Pro $14.99/mo yearly or $17.99 monthly (AI search plans) Highlighter limits, where data lives
Hypothesis Free plan with core annotation; paid plans are per student —
Web Highlights Free: unlimited highlights, bookmarks, notes, tags; sync in Premium/Ultimate Paid prices
Diigo — (pricing page is JS-only, homepage timed out) Everything
Memex — (no pricing on memex.garden) Everything

Evidence

  • pnpm lint: passes (8 warnings, the same ones as on main)
  • pnpm typecheck: 0 errors · pnpm test: 578/578 passed
  • pnpm size: 15.29 kB / 6.38 kB / 2.6 kB, all within budget
  • pnpm --filter docs build: 23 pages. /alternatives/ and /guides/highlight-without-spans/ are in sitemap-0.xml. JSON-LD: alternatives = TechArticle + BreadcrumbList + FAQPage (7), FAQ = FAQPage (11), guide = TechArticle.
  • Home: src/pages/index.astro is unchanged.

Merge Danger

Door: two-way

Docs and README copy only. The npm side is keywords and a patch changeset, which ships with the next release.

Blast Radius: docs

The anchors #what-is-stored, #orphans, #dynamic-content, #how-highlights-are-drawn and #errors-and-offline still work (some headings are now H3s). The old anchors on /extension/ (#how-do-i-install-it, #what-cant-it-do-yet) are gone, and nothing in the repo links to them.

…eywords

Rewrites the top of /extension/ and /extension/privacy/ with a definition and
question H2s, adds /alternatives/ (FAQPage schema) and the guide on highlighting
HTML text without spans, turns anchoring, React, REST storage and the FAQ into
question H2s with honest answers, and adds npm keywords, a README line and a
patch changeset.

Closes #59
@vercel

vercel Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
penciled Ready Ready Preview Oct 31, 2026 10:43pm UTC

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.

Search visibility: /extension/ rewrite, new /alternatives/, highlight-without-spans guide, question H2s, npm keywords

1 participant