Skip to content

docs: describe WordyMe as a self-hosted personal wiki - #106

Merged
AdminTeamCoderz merged 1 commit into
mainfrom
docs/reposition-personal-wiki
Aug 10, 2026
Merged

docs: describe WordyMe as a self-hosted personal wiki#106
AdminTeamCoderz merged 1 commit into
mainfrom
docs/reposition-personal-wiki

Conversation

@AdminTeamCoderz

@AdminTeamCoderz AdminTeamCoderz commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

The public copy still described WordyMe as "a centralized platform for students to manage educational information" — positioning the product has moved away from. Worse, the wording was inconsistent across four places that each reach a different audience, and two of them are the first thing anyone sees: the page meta description (what search engines index and what every shared link preview shows) and the OCI image label, which is baked into every published release. This replaces the education framing everywhere with one consistent description.

"Personal wiki" is deliberate, not a synonym for "wiki." Signup is only available while the database has no users (apps/backend/src/lib/auth.ts:23), so an instance holds exactly one account. The qualified term reaches people searching for a self-hosted wiki without promising collaboration the product does not offer — the unqualified word would attract users who would install it, find no way to add a teammate, and leave.

Related Issues

None — follow-up to the WordyMe branding work.

Fixes # — n/a

Type of Change

Documentation / copy. No behavior changes.

Changes

  • README.md — opening description rewritten; the mission line no longer references educational tools; the PRO paragraph now addresses "organizations" rather than "institutions", which read as schools.
  • DOCKERHUB.md — headline and opening paragraph rewritten (this is the Docker Hub landing page).
  • CONTRIBUTING.md — the "Make an impact" line and the Open Core paragraph no longer reference students or institutions.
  • apps/web/index.html — meta description: "Your own private wiki. Self-hosted notes and documentation, light enough to run on a Raspberry Pi."
  • apps/web/vite.config.ts — PWA manifest description matched to the same line.
  • .github/workflows/release-publish.yml — the org.opencontainers.image.description label (3 occurrences, one per build target) and the Docker Hub short description.
  • .github/workflows/verify-publishing.yml — the same short description, kept in sync.

Deliberately left alone: 'school' / 'university' in icon-picker.tsx (icon names users choose from, not copy), and the "campus NAT" examples in the Docker docs (technical illustrations of shared-IP rate limits).

How to Test

  1. pnpm --filter web build, then confirm the new line appears in dist/index.html (meta description) and dist/manifest.webmanifest (description).
  2. grep -ri "student\|educational\|edtech" --include="*.md" --include="*.html" --include="*.yml" . (excluding node_modules, dist) returns nothing.
  3. Read README.md and DOCKERHUB.md top-to-bottom — the description reads consistently in both.
  4. The workflow changes take effect on the next release: the published image's org.opencontainers.image.description label and the Docker Hub short description update automatically.

Expected result: one description, used everywhere; no education framing left in public copy.

Screenshots

Not a UI change — section not applicable.

Summary by CodeRabbit

  • Documentation

    • Updated product messaging to present WordyMe as a lightweight, private, self-hosted wiki and note-taking app.
    • Highlighted Docker and Raspberry Pi deployment, revision history, and real-time updates.
    • Refined contribution and commercial feature descriptions to reflect broader personal and organizational use.
  • Chores

    • Updated marketplace, application, and PWA descriptions to consistently reflect the new positioning.

@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5322e301-6f72-4f9c-88c4-a9c50c997384

📥 Commits

Reviewing files that changed from the base of the PR and between 1d59412 and b7344a1.

📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

WordyMe’s product messaging now describes a self-hosted personal wiki and note-taking application across documentation, Docker publishing workflows, and web metadata.

Changes

Product positioning

Layer / File(s) Summary
Documentation positioning
README.md, DOCKERHUB.md, CONTRIBUTING.md
Updates product, contribution, and commercial feature descriptions to reflect private tools, owned notes, and organizational use.
Publishing descriptions
.github/workflows/release-publish.yml, .github/workflows/verify-publishing.yml
Updates Docker image labels and Docker Hub descriptions to identify WordyMe as a self-hosted personal wiki and note-taking app.
Web metadata
apps/web/index.html, apps/web/vite.config.ts
Updates the HTML meta description and PWA manifest description to describe a private, self-hosted wiki.

Estimated code review effort: 1 (Trivial) | ~5 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely describes the primary documentation and copy change.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/reposition-personal-wiki

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 15: Update the descriptive phrase “Next Generation ERP Solution” to
“next-generation ERP solution” in the README, unless it is confirmed to be the
official product name.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d989bba3-8df8-49cd-bc0c-7a668ffbbd45

📥 Commits

Reviewing files that changed from the base of the PR and between 60a2dfc and 4e52ddd.

📒 Files selected for processing (7)
  • .github/workflows/release-publish.yml
  • .github/workflows/verify-publishing.yml
  • CONTRIBUTING.md
  • DOCKERHUB.md
  • README.md
  • apps/web/index.html
  • apps/web/vite.config.ts

Comment thread README.md Outdated
The public copy still described a platform for students managing
educational information — positioning the product has moved away from,
and which was inconsistent across four different places: the README, the
Docker Hub page, the page meta description, and the PWA manifest. Two of
those are the ones people actually see first, since the meta description
feeds search results and link previews, and the image label ships inside
every published release.

"Personal wiki" is deliberate rather than "wiki": signup is only
available while the database has no users, so an instance holds exactly
one account. The qualified term reaches people searching for a wiki
without promising collaboration the product does not have.

Copy only — no behavior changes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@AdminTeamCoderz
AdminTeamCoderz force-pushed the docs/reposition-personal-wiki branch from 1d59412 to b7344a1 Compare August 10, 2026 11:21
@AdminTeamCoderz
AdminTeamCoderz merged commit bd3de7d into main Aug 10, 2026
8 checks passed
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