Add CONTRIBUTING.md
This commit is contained in:
70
CONTRIBUTING.md
Normal file
70
CONTRIBUTING.md
Normal file
@@ -0,0 +1,70 @@
|
||||
# Contributing
|
||||
|
||||
Thank you for your interest in contributing to the OpenCode Obsidian plugin!
|
||||
|
||||
## What We Accept
|
||||
|
||||
We welcome the following types of contributions:
|
||||
|
||||
- Bug fixes
|
||||
- Performance improvements
|
||||
- Documentation improvements
|
||||
|
||||
**Note:** Core product features and major changes require prior discussion. Please [open an issue](https://github.com/mtymek/opencode-obsidian/issues) first to discuss your proposal before starting work. PRs for new features submitted without prior approval may be closed.
|
||||
|
||||
I'm also interested in collecting a set of Agent Skills useful in the context of Obsidian vaults. Feel free to submit an issue or PR with your ideas.
|
||||
|
||||
## Development Setup
|
||||
|
||||
### Requirements
|
||||
|
||||
- [Bun](https://bun.sh/) 1.3+
|
||||
- Obsidian (for testing the plugin)
|
||||
|
||||
### Getting Started
|
||||
|
||||
```bash
|
||||
git clone https://github.com/mtymek/opencode-obsidian.git
|
||||
cd opencode-obsidian
|
||||
bun install
|
||||
```
|
||||
|
||||
### Development Workflow
|
||||
|
||||
To work on the plugin during development:
|
||||
|
||||
1. Build the plugin:
|
||||
```bash
|
||||
bun run build # One-time production build
|
||||
```
|
||||
|
||||
2. The plugin will be built to `main.js` in the project root
|
||||
|
||||
3. For testing in Obsidian:
|
||||
- Enable Community Plugins in Obsidian settings
|
||||
- Copy the built plugin to your vault's `.obsidian/plugins/opencode-obsidian/` directory
|
||||
- Reload Obsidian or use the "Reload app without saving" command
|
||||
|
||||
### Commands
|
||||
|
||||
```bash
|
||||
bun install # Install dependencies
|
||||
bun run build # Production build with type checking
|
||||
bun test # Run tests
|
||||
```
|
||||
|
||||
## Before Submitting a PR
|
||||
|
||||
1. Run `bun run build` to ensure type checking passes
|
||||
2. Run `bun test` to ensure all tests pass
|
||||
3. Test the plugin in Obsidian to verify functionality
|
||||
|
||||
## Pull Requests
|
||||
|
||||
1. Keep PRs small and focused on a single concern
|
||||
2. Explain what your PR is attempting to fix or improve
|
||||
3. Link any relevant issues in the PR description
|
||||
|
||||
## License
|
||||
|
||||
By contributing to the OpenCode Obsidian plugin, you agree to license your contribution under the [MIT License](LICENSE).
|
||||
Reference in New Issue
Block a user