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