Shorten contribution file, add bug template

This commit is contained in:
Sander Declerck 2025-07-28 15:01:33 +02:00
parent bc690c2aa6
commit 784892826c
No known key found for this signature in database
2 changed files with 82 additions and 33 deletions

57
.github/CONTRIBUTING vendored
View file

@ -1,45 +1,36 @@
# Contributing to Aikido Safe Chain # Contributing to Aikido Safe Chain
Thank you for your interest in contributing to the Aikido Safe Chain! Before you start, please take a moment to read through our guidelines. Thank you for your interest in contributing! Please discuss significant changes in an issue first to avoid duplication of work.
## Reporting Issues ## Reporting Issues
If you encounter any issues while using the Aikido Safe Chain, please report them on our [GitHub Issues page](https://github.com/AikidoSec/safe-chain). Report issues on our [GitHub Issues page](https://github.com/AikidoSec/safe-chain). Check existing issues first and include:
- Steps to reproduce
Before creating a new issue, please check if the issue has already been reported or addressed in the documentation. If you find a similar issue, feel free to add any additional information that might help us resolve it. - Expected vs actual behavior
- Environment details (Node.js version, OS, package manager)
Please try to create bug reports that are: - Relevant logs/errors
- **Reproducible**: Include steps to reproduce the issue.
- **Clear**: Describe the issue in detail, including what you expected to happen and what
actually happened.
- **Environment**: Specify your environment, including the version of Node.js, the package manager you are using and its version, and your operating system.
- **Logs**: Include any relevant logs or error messages.
- **Scoped**: Please report a single issue per report.
## Contributing Code ## Contributing Code
To avoid your contribution is rejected, please engage with the community and maintainers before starting work on a new feature or significant change. You can do this by opening an issue to discuss your ideas or by discussing your ideas in an existing issue. This helps to avoid to accept contributions and avoids duplication of work. 1. Fork and clone the repository
2. Create a descriptive branch name
3. Make your changes following existing code style
4. Add tests for your changes
5. Run `npm test` and `npm run lint`
6. Push and create a pull request
If you would like to contribute code to the Aikido Safe Chain, please follow these steps: ## Development
1. **Fork the repository**: Create a fork of the Aikido Safe Chain repository on GitHub. **Setup:**
2. **Clone your fork**: Clone your forked repository to your local machine. ```bash
3. **Create a new branch**: Create a new branch for your changes. Use a descriptive name for the branch that reflects the changes you are making. npm install
4. **Make your changes**: Implement your changes in the new branch. Make sure to follow the coding style and conventions used in the project. ```
5. **Test your changes**: Please ensure that your changes are covered by tests and that all tests pass.
6. **Commit your changes**: Commit your changes with a clear and descriptive commit message.
7. **Push your changes**: Push your changes to your forked repository.
8. **Create a pull request**: Open a pull request against the main repository. Provide a clear description of your changes and reference any related issues.
### Development Environment **Commands:**
- `npm test` - Run tests
- `npm run test:watch` - Watch mode
- `npm run lint` - Check code style
To set up your development environment, you can follow these steps: **Requirements:**
- Node.js 18+
1. **Install Node.js**: Make sure you have Node.js version 18 or above installed on your machine. - Follow .editorconfig formatting
2. **Install dependencies**: Run `npm install` in the root directory of the project to install the necessary dependencies.
3. **Run tests**: You can run the tests using `npm test` to ensure that everything is working correctly.
### Code Style
Our style guides are documented in the .editorconfig file in the root of the repository. Use Prettier to format your code according to these guidelines. You can run Prettier manually or set it up to run automatically on save in your code editor.

58
.github/ISSUE_TEMPLATE/bug_report.yml vendored Normal file
View file

@ -0,0 +1,58 @@
name: Bug Report
description: Report a bug to help us improve
title: "[Bug]: "
labels: ["bug"]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report a bug! Please fill out the sections below to help us understand and reproduce the issue.
- type: textarea
id: description
attributes:
label: Bug Description
description: A clear and concise description of what the bug is
placeholder: Describe what happened and what you expected to happen
validations:
required: true
- type: textarea
id: reproduce
attributes:
label: Steps to Reproduce
description: Steps to reproduce the behavior
placeholder: |
1. Run command '...'
2. Install package '...'
3. See error
validations:
required: true
- type: textarea
id: environment
attributes:
label: Environment
description: Your system information
placeholder: |
- OS: [e.g. macOS 14.0, Ubuntu 22.04, Windows 11]
- Node.js version: [e.g. 18.17.0]
- Package manager: [e.g. npm 9.6.7, yarn 1.22.19, pnpm 8.6.0]
- Safe Chain version: [e.g. 1.0.0]
validations:
required: true
- type: textarea
id: logs
attributes:
label: Error Logs
description: Relevant error messages or logs
placeholder: Paste any error messages or logs here
render: shell
- type: textarea
id: additional
attributes:
label: Additional Context
description: Any other context about the problem
placeholder: Screenshots, related issues, workarounds, etc.