Thanks for your interest in contributing! This document outlines the process and guidelines.
-
Setup
# Fork and clone the repo git clone https://github.com/your-username/confluence-scraper.git cd confluence-scraper # Install dependencies pnpm install # Prepare scripts pnpm prepare
-
Code Style
- Use JSDoc for type safety and documentation
- Follow existing patterns
- Run formatter before committing
pnpm format
-
Branch Naming
feature/descriptionfor new featuresfix/descriptionfor bug fixesdocs/descriptionfor documentation changes
-
Commit Messages
- Clear and descriptive
- Reference issues if applicable
- Use present tense ("Add feature" not "Added feature")
-
Documentation
- Update README.md if needed
- Add JSDoc comments
- Update architecture decision records if making significant changes
- Error Handling
- Use centralized error handling
- Implement retries for transient failures
- Provide clear error messages
- Check existing architecture decisions
- Review test implementations
- Open an issue for discussion