Skip to content

Add/chatroom#5

Merged
BretRen merged 3 commits intomainfrom
add/chatroom
Oct 2, 2025
Merged

Add/chatroom#5
BretRen merged 3 commits intomainfrom
add/chatroom

Conversation

@BretRen
Copy link
Copy Markdown
Member

@BretRen BretRen commented Oct 2, 2025

Add contribue.md & update config.mts(sidebar)

Summary by CodeRabbit

  • Documentation
    • Added a Chinese contributor guide explaining how to request features, report bugs, submit code, safety contacts, and repository links.
    • Updated the Chinese sidebar with a new “平台” section linking to the contributor guide for easier access.
    • Fixed a formatting issue in the Chatroom doc to restore proper block closure.
    • Refined wording in the workspace deletion section for improved clarity.

Copilot AI review requested due to automatic review settings October 2, 2025 03:23
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Oct 2, 2025

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

Walkthrough

Replaces a closing block marker in zh/chatroom/index.md, tweaks wording in zh/chatroom/workspace.md, adds a new zh/platform/contribute.md contributor guide, and updates zh/config.mts to include a "平台" sidebar group linking to the new page.

Changes

Cohort / File(s) Summary of Changes
Chatroom docs
zh/chatroom/index.md, zh/chatroom/workspace.md
zh/chatroom/index.md: replaced end-of-file directive from -::: to +::: to properly close the preceding block. zh/chatroom/workspace.md: minor wording change in “删除工作区” (removed the leading “你”).
ZH site config
zh/config.mts
Added a new sidebar section object: text: "平台" with one item linking to /zh/platform/contribute.md.
Platform docs
zh/platform/contribute.md
Added new contributor guide covering feature requests, bug reports, code submissions, repository links, behavioral rules, safety contact instructions, and exceptions.

Sequence Diagram(s)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • update workspace #3 — Touches zh/chatroom/workspace.md and the same trailing block marker change; closely related to the wording/end-marker edits in this PR.

Poem

小兔跃过文档径,
把标记改成正尾声。
新页挂上“平台”名,
话语微调不添营。
我啃胡萝卜,敲键庆生。 🐇✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Title Check ⚠️ Warning The title “Add/chatroom” does not accurately reflect the changes in this pull request, which primarily add a contributor guide document and update the documentation sidebar configuration, not introduce a chatroom feature. As a result, the title is misleading and fails to summarize the main intent of the changeset. Please rename the pull request to clearly describe the primary changes, for example “Add contributor guide and update sidebar navigation,” so that reviewers immediately understand the addition of the new document and the sidebar configuration updates.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.
✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch add/chatroom

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

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR adds a contribution guide in Chinese and updates the navigation structure by adding a new "Platform" section to the sidebar.

  • Adds a comprehensive contribution guide (contribute.md) for open source projects
  • Updates the sidebar configuration to include a new "Platform" section
  • Makes minor text improvements to existing documentation

Reviewed Changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File Description
zh/platform/contribute.md Adds new contribution guide with rules for feature requests, bug reports, and code submissions
zh/config.mts Updates sidebar to add new "Platform" section with link to contribution guide
zh/chatroom/workspace.md Minor text improvement removing redundant "你" pronoun
zh/chatroom/index.md Adds a card component (appears to be testing content)

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Comment thread zh/platform/contribute.md Outdated
Comment thread zh/platform/contribute.md Outdated
Comment thread zh/chatroom/index.md Outdated
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (4)
zh/config.mts (1)

26-26: Remove .md extension for consistency.

Other sidebar links don't include the .md extension (e.g., line 19: /zh/introduction). For consistency, remove it here.

Apply this diff:

-          { text: "贡献/提交bug", link: "/zh/platform/contribute.md" },
+          { text: "贡献/提交bug", link: "/zh/platform/contribute" },
zh/platform/contribute.md (3)

23-23: Use proper heading instead of bold text.

The bold text "发布" should be a heading for better document structure.

Apply this diff:

-**发布**
+### 发布

34-34: Format email as markdown link.

The bare email URL should be formatted as a proper markdown link for better accessibility and consistency.

Apply this diff:

-对于安全问题,请联系bret@pdnode.com
+对于安全问题,请联系 [bret@pdnode.com](mailto:bret@pdnode.com)

13-17: Consider extracting duplicate rules.

The rules for feature requests (lines 13-17) and code submission (lines 41-45) are nearly identical. Consider extracting them into a common "General Rules" section referenced by both.

For example, add a general rules section at the beginning:

## 通用规则

所有贡献必须遵守以下规则:
- 尊重他人
- 禁止骂人
- 禁止发布R18和青少年不友好内容([部分项目例外](#r18--青少年不友好内容))
- 禁止发布/提交无用的内容(对服务无用的)

::: tip
Pdnode保留所有权利包括更改此规则,禁止用户等。
:::

Then reference it in each section instead of duplicating the rules.

Also applies to: 41-45

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f47a20f and e279592.

📒 Files selected for processing (4)
  • zh/chatroom/index.md (1 hunks)
  • zh/chatroom/workspace.md (1 hunks)
  • zh/config.mts (1 hunks)
  • zh/platform/contribute.md (1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
zh/platform/contribute.md

23-23: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


34-34: Bare URL used

(MD034, no-bare-urls)

🔇 Additional comments (2)
zh/chatroom/workspace.md (1)

37-37: LGTM! Improved clarity.

The removal of "你" makes the statement more direct and consistent with documentation tone.

zh/chatroom/index.md (1)

24-26: Confirm Card component registration and replace placeholder content
Ensure Card is imported or globally registered by your VitePress theme before use, and replace the placeholder slot text with actual quick-start instructions.

Comment thread zh/platform/contribute.md Outdated
Comment thread zh/platform/contribute.md Outdated
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (2)
zh/platform/contribute.md (2)

23-25: Use a heading instead of bold text.

MD036 flags this line—swap the bolded text for a proper heading to keep markdownlint clean.

-**发布**
+### 发布

34-36: Wrap the email as a mailto: link.

MD034 complains about the bare address. A mailto link resolves it and keeps lint quiet.

-对于安全问题,请联系bret@pdnode.com
+对于安全问题,请联系[安全问题邮箱](mailto:bret@pdnode.com)
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e279592 and 0f588fd.

📒 Files selected for processing (2)
  • zh/chatroom/index.md (1 hunks)
  • zh/platform/contribute.md (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • zh/chatroom/index.md
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
zh/platform/contribute.md

23-23: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


34-34: Bare URL used

(MD034, no-bare-urls)

@BretRen BretRen merged commit 17d5173 into main Oct 2, 2025
1 check was pending
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