Skip to content

docs: update README.md and CONTRIBUTING.md#567

Open
msampathkumar wants to merge 4 commits into
mainfrom
sampath_repo_readme
Open

docs: update README.md and CONTRIBUTING.md#567
msampathkumar wants to merge 4 commits into
mainfrom
sampath_repo_readme

Conversation

@msampathkumar
Copy link
Copy Markdown

@msampathkumar msampathkumar commented May 15, 2026

Description

We are updating the repository's foundational documentation to streamline the onboarding experience for new contributors and ensure consistent code quality.

Summary of Updates:

  1. README.md: Added a 2-step Quick Start guide for running the helloworld sample and a Repository Structure directory table.

  2. CONTRIBUTING.md: Fully detailed the local development workflow using uv. Added step-by-step commands for running linting (ruff), type checking (mypy/pyright), and test coverage (pytest).

    Note: As of now mypy, pyright and pytest are added as suggestion only.

  3. Tooling Configurations: Bumped ruff line-length to 100 in .ruff.toml and add static analysis tools (mypy, pyright, pytest) in pyproject.toml.

…e for samples.

Also update contribution guide and provide tips on linter checks, typehints and pytests.
@msampathkumar msampathkumar requested review from holtskinner and zeroasterisk and removed request for zeroasterisk May 15, 2026 14:32
Copy link
Copy Markdown
Contributor

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

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 updates the project's configuration and documentation to improve the developer experience and project clarity. Key changes include increasing the Ruff line length to 100, adding uv.lock to the exclusion list, and providing comprehensive updates to CONTRIBUTING.md and README.md regarding setup, workflows, and protocol features. Additionally, testing and type-checking tools were added to pyproject.toml. Reviewers suggested moving development tools to a specific dependency group, correcting a typo, removing redundant CLI flags in documentation, and refining a heading for better conciseness.

Comment thread pyproject.toml Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md
Comment thread README.md Outdated
@msampathkumar msampathkumar force-pushed the sampath_repo_readme branch from 06fb433 to 36f08a8 Compare May 15, 2026 14:48
@msampathkumar msampathkumar changed the title docs: update README with repo structure and add linting/testing workflows to CONTRIBUTING.md docs: update README.md and CONTRIBUTING.md May 15, 2026
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