Skip to content

improve README onboarding and project documentation - #230

Open
Draxsis wants to merge 1 commit into
agentsmd:mainfrom
Draxsis:patch-1
Open

improve README onboarding and project documentation#230
Draxsis wants to merge 1 commit into
agentsmd:mainfrom
Draxsis:patch-1

Conversation

@Draxsis

@Draxsis Draxsis commented Aug 14, 2026

Copy link
Copy Markdown

Summary

Improves the README to make AGENTS.md easier to understand and adopt for first-time visitors.

Changes

  • Clarify the purpose of AGENTS.md and how it complements README files
  • Add a short "Why AGENTS.md?" section
  • Add a simple getting-started example
  • Improve the existing AGENTS.md example for readability
  • Add guidance for writing clear, actionable agent instructions
  • Improve the local website setup instructions
  • Fix minor wording and formatting issues

Motivation

The existing README explains the basic concept well, but new users have to infer how to get started and what kinds of instructions belong in an AGENTS.md file.

This update aims to make the project easier to understand within the first few moments of visiting the repository while keeping the documentation concise and approachable.

No functional changes are included.

@vercel

vercel Bot commented Aug 14, 2026

Copy link
Copy Markdown

@Draxsis is attempting to deploy a commit to the openai Team on Vercel.

A member of the Team first needs to authorize it.

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