Skip to content

docs: rewrite core documentation for clarity and engagement#975

Open
Copilot wants to merge 5 commits intomasterfrom
copilot/rewrite-docs-pages-engaging
Open

docs: rewrite core documentation for clarity and engagement#975
Copilot wants to merge 5 commits intomasterfrom
copilot/rewrite-docs-pages-engaging

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Feb 15, 2026

Rewrote 4 high-impact documentation files to improve user onboarding and reduce friction for new users.

Files Changed

  • docs/overview.mdx - Main landing page
  • docs/basic/core-concepts.md - Core concepts guide
  • docs/basic/try-with-docker.md - Quick start guide
  • docs/contributing.md - Contributor guide

Key Improvements

  • Progressive disclosure: Start with simple concepts, layer in complexity
  • Real examples: Replace abstract descriptions with concrete use cases
  • Scannability: Add tables, emojis, clear headings for quick navigation
  • Action-oriented: Include troubleshooting, next steps, and clear CTAs
  • Conversational tone: Remove formal language barriers

Example

Before:

Casdoor is a UI-first Identity Access Management (IAM) / Single-Sign-On (SSO) 
platform with a web UI that supports OAuth 2.0, OIDC, SAML, CAS, LDAP, SCIM, 
WebAuthn, TOTP, MFA, RADIUS, Google Workspace, Active Directory, and Kerberos.

After:

## What is Casdoor?

Casdoor is a modern, UI-first Identity Access Management (IAM) and Single-Sign-On 
(SSO) platform that makes authentication and user management simple and secure. 
Whether you're building a small app or managing enterprise-scale authentication, 
Casdoor provides everything you need in one elegant package.

With support for OAuth 2.0, OIDC, SAML, LDAP, and many more protocols, Casdoor 
seamlessly integrates with your existing infrastructure while providing a beautiful 
web interface for managing users, applications, and authentication flows.

Scope

These 4 files represent primary entry points for new users. Remaining 252 documentation files can follow the same patterns.

Original prompt

This section details on the original issue you should resolve

<issue_title>[feature] rewrite all docs pages to be more natural and engaging</issue_title>
<issue_description></issue_description>

Comments on the Issue (you are @copilot in this section)


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@netlify
Copy link
Copy Markdown

netlify Bot commented Feb 15, 2026

Deploy Preview for iridescent-baklava-0d7550 failed.

Name Link
🔨 Latest commit 03f83a5
🔍 Latest deploy log https://app.netlify.com/projects/iridescent-baklava-0d7550/deploys/6991f94ff292ae0008f48117

Copilot AI and others added 2 commits February 15, 2026 16:41
Co-authored-by: hsluoyz <3787410+hsluoyz@users.noreply.github.com>
Co-authored-by: hsluoyz <3787410+hsluoyz@users.noreply.github.com>
@hsluoyz hsluoyz marked this pull request as ready for review February 15, 2026 16:47
Copilot AI and others added 2 commits February 15, 2026 16:47
…leshooting

Co-authored-by: hsluoyz <3787410+hsluoyz@users.noreply.github.com>
Co-authored-by: hsluoyz <3787410+hsluoyz@users.noreply.github.com>
Copilot AI changed the title [WIP] Rewrite all documentation pages for better engagement docs: rewrite core documentation for clarity and engagement Feb 15, 2026
Copilot AI requested a review from hsluoyz February 15, 2026 16:53
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.

[feature] rewrite all docs pages to be more natural and engaging

3 participants