Skip to content

Commit

Permalink
Refine README and add CONTRIBUTING guide (#22)
Browse files Browse the repository at this point in the history
  • Loading branch information
blizard863 authored Jun 16, 2024
1 parent f6f5bee commit a051f09
Show file tree
Hide file tree
Showing 3 changed files with 46 additions and 1 deletion.
39 changes: 39 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Contributing to tiny-frpc

We welcome contributions to the tiny-frpc project. Whether you're looking to report an issue, submit a bug fix, or propose a new feature, here's how you can contribute.

## Reporting Issues

Before submitting an issue, please check the issue tracker to avoid duplicates. When creating an issue, provide as much relevant information as possible, including:

- A clear and descriptive title
- Steps to reproduce the issue
- Expected behavior
- Actual behavior
- Any relevant logs or error messages

## Pull Requests

We encourage pull requests from everyone. Here are some guidelines to help you get started:

1. Fork the repository and create your branch from `main`.
2. If you've added code, add tests! Ensure the test suite passes.
3. If you've changed APIs, update the documentation.
4. Ensure your code follows the coding standards used throughout the project.
5. Include a clear and detailed description of the pull request.

## Coding Standards

- Write clean, maintainable, and idiomatic code.
- Follow the [Go Code Review Comments](https://github.com/golang/go/wiki/CodeReviewComments) for Go code.
- Use meaningful variable names and function names.
- Comment your code where necessary, but prefer self-explanatory code.

## Testing Requirements

- Add unit tests for new features or bug fixes.
- Ensure that your changes do not break existing tests.
- Run the full test suite before submitting your pull request.

Thank you for contributing to tiny-frpc! Your efforts help make the project better for everyone.

5 changes: 4 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,10 @@ Assuming that the domain name 'test-tiny-frpc.frps.com' is resolved to the machi
# Principle
![how tiny frpc works](doc/pic/architecture.png)

# Contributing

We welcome contributions to the tiny-frpc project. If you're interested in helping, you can find the contributing guidelines in our [CONTRIBUTING.md](CONTRIBUTING.md) file. We look forward to your pull requests and issue reports.

# Disclaimer

**This is currently a preview version. Compatibility is not guaranteed. It is presently for testing purposes only and should not be used in production environments!**
**This is currently a preview version. Compatibility is not guaranteed. It is presently for testing purposes only and should not be used in production environments!**
3 changes: 3 additions & 0 deletions README_zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,9 @@ HTTP 服务:
# 原理
![how tiny frpc works](doc/pic/architecture.png)

# 贡献

我们欢迎对 tiny-frpc 项目的贡献。如果您有兴趣帮助,请在我们的 [CONTRIBUTING.md](CONTRIBUTING.md) 文件中找到贡献指南。我们期待您的Pull Requests 和 Issue 报告。

# 说明

Expand Down

0 comments on commit a051f09

Please sign in to comment.