Skip to content

docs(readme): move scam/retention alerts below header, soften tone - #1608

Merged
igorls merged 1 commit into
developfrom
chore/readme-move-scam-alert-below-header
May 24, 2026
Merged

igorls merged 1 commit into
developfrom
chore/readme-move-scam-alert-below-header

Conversation

@igorls

@igorls igorls commented May 24, 2026

Copy link
Copy Markdown
Member

Summary

  • The CAUTION (scam alert) and IMPORTANT (Claude Code retention) admonitions sat above the logo + title, so the first content on the repo page was loud red warnings rather than the project introduction. Moves both below the header.
  • Softens the scam block: drops the # 🚨 CRITICAL SECURITY WARNING: BEWARE OF SCAMS H1, all-caps shouting, and the duplicate 🚨 emoji on the retention block. Same information (impostor-domain warning, official sources list, malware caveat, link to docs/HISTORY.md) in a single-paragraph CAUTION.
  • Targets v3.3.6.

Test plan

  • Render check on github.com/MemPalace/mempalace once merged (or via PR preview) — confirm header reads first, admonitions still legible.

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.
Copilot AI review requested due to automatic review settings May 24, 2026 16:48
@igorls
igorls requested a review from milla-jovovich as a code owner May 24, 2026 16:48

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.

Comment thread README.md
</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).

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

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.

Comment thread README.md
Comment on lines +16 to +17
> [!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).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

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.

Suggested change
> [!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).

Comment thread README.md
Comment on lines +19 to +22
> [!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).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

medium

The [!IMPORTANT] block also contains lines exceeding the 100-character limit. Wrapping these lines improves readability and adheres to the repository's formatting guidelines.

Suggested change
> [!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).

@igorls
igorls merged commit be819da into develop May 24, 2026
7 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.

2 participants