docs(readme): move scam/retention alerts below header, soften tone - #1608
Conversation
The scam-alert and Claude-Code-retention admonitions were the first content visitors saw on the repo page — louder than the project introduction. Moves both below the logo/title/badges so the project identity reads first, and softens the scam block (drops the H1 "CRITICAL SECURITY WARNING" + all-caps shouting + redundant emoji) to a single-paragraph CAUTION. All factual content preserved: impostor-domain warning, official sources, malware caveat, link to docs/HISTORY.md.
There was a problem hiding this comment.
Pull request overview
Reorders and rewrites the README’s top-of-page alerts so the project header (logo/title/summary) is the first visible content, while keeping the scam and Claude Code retention notices prominent but less “shouty”.
Changes:
- Moves the CAUTION (scam/impostor-site) and IMPORTANT (Claude Code retention) admonitions below the centered header block.
- Consolidates/softens the scam warning copy into a single-paragraph CAUTION block and removes redundant alarm styling in the retention notice.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| </div> | ||
|
|
||
| > [!CAUTION] | ||
| > **Beware of impostor sites.** MemPalace has no other official websites. The **only** official sources are this **[GitHub repository](https://github.com/MemPalace/mempalace)**, the **[PyPI package](https://pypi.org/project/mempalace/)**, and the docs at **[mempalaceofficial.com](https://mempalaceofficial.com)**. Any other domain (including `.tech`, `.net`, or other `.com` variants) is an impostor and may distribute malware. Details and timeline: [docs/HISTORY.md](docs/HISTORY.md). |
There was a problem hiding this comment.
Code Review
This pull request relocates and condenses the security warning and Claude Code session notice within the README.md file, moving them from the top of the document to a position below the header section. The review feedback suggests wrapping the long lines in these newly added blocks to adhere to a 100-character line limit, which will improve readability and maintainability.
| > [!CAUTION] | ||
| > **Beware of impostor sites.** MemPalace has no other official websites. The **only** official sources are this **[GitHub repository](https://github.com/MemPalace/mempalace)**, the **[PyPI package](https://pypi.org/project/mempalace/)**, and the docs at **[mempalaceofficial.com](https://mempalaceofficial.com)**. Any other domain (including `.tech`, `.net`, or other `.com` variants) is an impostor and may distribute malware. Details and timeline: [docs/HISTORY.md](docs/HISTORY.md). |
There was a problem hiding this comment.
The added [!CAUTION] block is currently a single very long line (465 characters). Following the project's preference for a 100-character line limit (as mentioned in CONTRIBUTING.md), wrapping this text would significantly improve maintainability and make future diffs easier to read in line-based tools.
| > [!CAUTION] | |
| > **Beware of impostor sites.** MemPalace has no other official websites. The **only** official sources are this **[GitHub repository](https://github.com/MemPalace/mempalace)**, the **[PyPI package](https://pypi.org/project/mempalace/)**, and the docs at **[mempalaceofficial.com](https://mempalaceofficial.com)**. Any other domain (including `.tech`, `.net`, or other `.com` variants) is an impostor and may distribute malware. Details and timeline: [docs/HISTORY.md](docs/HISTORY.md). | |
| > [!CAUTION] | |
| > **Beware of impostor sites.** MemPalace has no other official websites. The **only** official | |
| > sources are this **[GitHub repository](https://github.com/MemPalace/mempalace)**, the | |
| > **[PyPI package](https://pypi.org/project/mempalace/)**, and the docs at | |
| > **[mempalaceofficial.com](https://mempalaceofficial.com)**. Any other domain (including | |
| > `.tech`, `.net`, or other `.com` variants) is an impostor and may distribute malware. | |
| > Details and timeline: [docs/HISTORY.md](docs/HISTORY.md). |
| > [!IMPORTANT] | ||
| > **Claude Code sessions expire in 30 days without auto-save hooks wired.** [Read this →](https://github.com/MemPalace/mempalace/discussions/1388) | ||
| > | ||
| > Need the shortest recovery/setup path? Use the [Claude Code retention setup checklist](https://mempalaceofficial.com/guide/claude-code-retention.html). |
There was a problem hiding this comment.
The [!IMPORTANT] block also contains lines exceeding the 100-character limit. Wrapping these lines improves readability and adheres to the repository's formatting guidelines.
| > [!IMPORTANT] | |
| > **Claude Code sessions expire in 30 days without auto-save hooks wired.** [Read this →](https://github.com/MemPalace/mempalace/discussions/1388) | |
| > | |
| > Need the shortest recovery/setup path? Use the [Claude Code retention setup checklist](https://mempalaceofficial.com/guide/claude-code-retention.html). | |
| > [!IMPORTANT] | |
| > **Claude Code sessions expire in 30 days without auto-save hooks wired.** | |
| > [Read this →](https://github.com/MemPalace/mempalace/discussions/1388) | |
| > | |
| > Need the shortest recovery/setup path? Use the | |
| > [Claude Code retention setup checklist](https://mempalaceofficial.com/guide/claude-code-retention.html). |
Summary
# 🚨 CRITICAL SECURITY WARNING: BEWARE OF SCAMSH1, all-caps shouting, and the duplicate 🚨 emoji on the retention block. Same information (impostor-domain warning, official sources list, malware caveat, link todocs/HISTORY.md) in a single-paragraph CAUTION.Test plan