mirror of
https://github.com/alexgo-io/stacks-blockchain-api.git
synced 2026-01-12 16:53:19 +08:00
docs: Blockchain api overview add note (#1706)
* chore: improve README.md standardization (#1692) * Updated overview page to use openapi and source code repo links --------- Co-authored-by: Scott McClellan <scott.mcclellan@gmail.com>
This commit is contained in:
19
.github/CONTRIBUTING.md
vendored
Normal file
19
.github/CONTRIBUTING.md
vendored
Normal file
@@ -0,0 +1,19 @@
|
||||
# Contributing
|
||||
|
||||
Thank you for considering contributing to this product! We welcome any contributions, whether it's bug fixes, new features, or improvements to the existing codebase.
|
||||
|
||||
### Your First Pull Request
|
||||
|
||||
Working on your first Pull Request? You can learn how from this free video series:
|
||||
|
||||
[How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github)
|
||||
|
||||
To help you get familiar with our contribution process, we have a list of [good first issues](../../issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) that contain bugs that have a relatively limited scope. This is a great place to get started.
|
||||
|
||||
If you decide to fix an issue, please be sure to check the comment thread in case somebody is already working on a fix. If nobody is working on it at the moment, please leave a comment stating that you intend to work on it so other people don’t accidentally duplicate your effort.
|
||||
|
||||
If somebody claims an issue but doesn’t follow up for more than two weeks, it’s fine to take it over but you should still leave a comment. **Issues won't be assigned to anyone outside the core team**.
|
||||
|
||||
### Contribution Prerequisites
|
||||
|
||||
... 🚧 Work in progress 🚧 ...
|
||||
4
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
4
.github/ISSUE_TEMPLATE/config.yml
vendored
Normal file
@@ -0,0 +1,4 @@
|
||||
contact_links:
|
||||
- name: Ask the community
|
||||
url: https://discord.gg/KrqnVg8D
|
||||
about: Ask and discuss questions with other Stacks community developers.
|
||||
@@ -166,6 +166,37 @@ could be ran:
|
||||
time during import, but sacrifices some historical data. You can use this mode if you're mostly
|
||||
interested in running an API that prioritizes real time information.
|
||||
|
||||
# Client library
|
||||
## Bugs and feature requests
|
||||
|
||||
You can use the Stacks Blockchain API Client library if you require a way to call the API via JavaScript or receive real-time updates via Websockets or Socket.io. Learn more [here](client/README.md).
|
||||
If you encounter a bug or have a feature request, we encourage you to follow the steps below:
|
||||
|
||||
1. **Search for existing issues:** Before submitting a new issue, please search [existing and closed issues](../../issues) to check if a similar problem or feature request has already been reported.
|
||||
1. **Open a new issue:** If it hasn't been addressed, please [open a new issue](../../issues/new/choose). Choose the appropriate issue template and provide as much detail as possible, including steps to reproduce the bug or a clear description of the requested feature.
|
||||
1. **Evaluation SLA:** Our team reads and evaluates all the issues and pull requests. We are avaliable Monday to Friday and we make a best effort to respond within 7 business days.
|
||||
|
||||
Please **do not** use the issue tracker for personal support requests or to ask for the status of a transaction. You'll find help at the [#support Discord channel](https://discord.gg/SK3DxdsP).
|
||||
|
||||
## Contribute
|
||||
|
||||
Development of this product happens in the open on GitHub, and we are grateful to the community for contributing bugfixes and improvements. Read below to learn how you can take part in improving the product.
|
||||
|
||||
### Code of Conduct
|
||||
Please read our [Code of conduct](../../../.github/blob/main/CODE_OF_CONDUCT.md) since we expect project participants to adhere to it.
|
||||
|
||||
### Contributing Guide
|
||||
Read our [contributing guide](.github/CONTRIBUTING.md) to learn about our development process, how to propose bugfixes and improvements, and how to build and test your changes.
|
||||
|
||||
### Community
|
||||
|
||||
Join our community and stay connected with the latest updates and discussions:
|
||||
|
||||
- [Join our Discord community chat](https://discord.gg/ZQR6cyZC) to engage with other users, ask questions, and participate in discussions.
|
||||
|
||||
- [Visit hiro.so](https://www.hiro.so/) for updates and subcribing to the mailing list.
|
||||
|
||||
- Follow [Hiro on Twitter.](https://twitter.com/hirosystems)
|
||||
|
||||
|
||||
## Client library
|
||||
|
||||
You can use the Stacks Blockchain API Client library if you require a way to call the API via JavaScript or receive real-time updates via Websockets or Socket.io. Learn more [here](client/README.md).
|
||||
@@ -8,6 +8,12 @@ The Stacks blockchain API allows you to query the Stacks blockchain and interact
|
||||
|
||||
The Stacks Blockchain API is hosted by Hiro. Using it requires you to trust the hosted server, but this API also provides a faster development experience. You may wish to consider running your own API instance to create a fully trustless architecture for your app.
|
||||
|
||||
> **_NOTE:_**
|
||||
>
|
||||
> To explore the detailed documentation for the API endpoints, request and response formats, you can refer to the [OpenAPI specification](https://docs.hiro.so/api).
|
||||
>
|
||||
> The source code for this project is available in our [GitHub repository](https://github.com/hirosystems/stacks-blockchain-api). You can explore the codebase, [contribute](https://docs.hiro.so/contributors-guide), and raise [issues](https://github.com/hirosystems/stacks-blockchain-api/issues) or [pull requests](https://github.com/hirosystems/stacks-blockchain-api/pulls).
|
||||
|
||||
## Architecture
|
||||
|
||||

|
||||
|
||||
Reference in New Issue
Block a user