Skip to content

docs: refactor contributing section and add AI development setup#29

Merged
hrntknr merged 1 commit intomainfrom
docs/refactor-contributing-section
Aug 18, 2025
Merged

docs: refactor contributing section and add AI development setup#29
hrntknr merged 1 commit intomainfrom
docs/refactor-contributing-section

Conversation

@hrntknr
Copy link
Copy Markdown
Member

@hrntknr hrntknr commented Aug 18, 2025

Summary

This PR refactors the documentation structure by extracting contributing guidelines from README.md into a dedicated CONTRIBUTING.md file and adds AI development environment setup instructions. This improves organization and makes it easier for developers to find contribution guidelines.

Changes

  • Created CONTRIBUTING.md with commit message guidelines and PR template reference
  • Updated README.md to reference the new contributing document
  • Added AI development environment setup section with symlink instructions for Claude Code, Gemini, and GitHub Copilot
  • Updated .gitignore to exclude AI-specific instruction files

Type of Change

  • docs: Documentation only changes

Related Issues

- Move detailed contributing guidelines to CONTRIBUTING.md
- Add AI development environment setup instructions
- Update .gitignore to exclude AI assistant instruction files
- Simplify README contributing section with reference to CONTRIBUTING.md
Copilot AI review requested due to automatic review settings August 18, 2025 11:56
@hrntknr hrntknr merged commit d4deea9 into main Aug 18, 2025
4 checks passed
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 improves documentation organization by extracting developer contribution guidelines from README.md into a dedicated CONTRIBUTING.md file and adds AI development environment setup instructions. This separation makes contribution guidelines more discoverable and provides standardized integration with AI coding assistants.

  • Extracted commit message guidelines and PR template references into a dedicated CONTRIBUTING.md file
  • Added AI development environment setup with symlink instructions for popular AI assistants
  • Updated README.md to reference the new contributing document instead of inline guidelines

Reviewed Changes

Copilot reviewed 2 out of 3 changed files in this pull request and generated 1 comment.

File Description
README.md Replaced inline contribution guidelines with reference to CONTRIBUTING.md and added AI development environment setup section
CONTRIBUTING.md New file containing commit message conventions, examples, and PR template reference extracted from README.md

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

Comment thread README.md

# For GitHub Copilot
mkdir -p .github
ln -s CONTRIBUTING.md .github/copilot-instructions.md
Copy link

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

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

The symlink command uses a relative path 'CONTRIBUTING.md' which will not work correctly when creating the symlink inside the .github directory. The command should use '../CONTRIBUTING.md' to properly reference the file from the .github subdirectory.

Suggested change
ln -s CONTRIBUTING.md .github/copilot-instructions.md
ln -s ../CONTRIBUTING.md .github/copilot-instructions.md

Copilot uses AI. Check for mistakes.
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