You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The current contributing documentation provides some useful details about the repository's background, dependencies, and processes, but it could benefit from additional structure and information to make it more accessible for first-time contributors. Below are a few suggestions to enhance the setup guide and address gaps:
Suggested Improvements:
Pre-requisites:
Clarify tools, versions, and environment setup required before contributing (e.g., Go version, OS compatibility, protoc compiler requirements, etc.).
Specify the dependencies for local development and testing (e.g., Docker, specific Go modules, or any system-level packages).
Dependency Installation:
Provide step-by-step instructions for installing required dependencies, including protoc-gen-go and protoc-gen-go-grpc.
Detail any additional setup for go.work usage during local development.
Local Run/Build:
Explain how to run or build the repository locally.
Include specific commands and expected outcomes (e.g., running the ./proto/generate.sh script or testing the ArrowStreamService gRPC service).
Testing:
Include a section on how to execute tests locally, with commands and testing frameworks used.
Clarify whether Docker or any external test dependencies are required.
Further Help:
Provide links to additional documentation or slack channel for contributors seeking more guidance.
Why This Matters:
Improving the setup guide will lower the barrier for first-time contributors, streamline the onboarding process, and make it easier for developers to contribute effectively to the project. A clear and detailed guide also reduces confusion and support requests, ultimately enhancing the project's community engagement.
Would you consider enhancing the documentation to address these areas?
I’d be happy to assist with creating a pull request to add these information if they can be provided.
The text was updated successfully, but these errors were encountered:
The current contributing documentation provides some useful details about the repository's background, dependencies, and processes, but it could benefit from additional structure and information to make it more accessible for first-time contributors. Below are a few suggestions to enhance the setup guide and address gaps:
Suggested Improvements:
Clarify tools, versions, and environment setup required before contributing (e.g., Go version, OS compatibility, protoc compiler requirements, etc.).
Specify the dependencies for local development and testing (e.g., Docker, specific Go modules, or any system-level packages).
Provide step-by-step instructions for installing required dependencies, including protoc-gen-go and protoc-gen-go-grpc.
Detail any additional setup for go.work usage during local development.
Explain how to run or build the repository locally.
Include specific commands and expected outcomes (e.g., running the ./proto/generate.sh script or testing the ArrowStreamService gRPC service).
Include a section on how to execute tests locally, with commands and testing frameworks used.
Clarify whether Docker or any external test dependencies are required.
Provide links to additional documentation or slack channel for contributors seeking more guidance.
Why This Matters:
Improving the setup guide will lower the barrier for first-time contributors, streamline the onboarding process, and make it easier for developers to contribute effectively to the project. A clear and detailed guide also reduces confusion and support requests, ultimately enhancing the project's community engagement.
Would you consider enhancing the documentation to address these areas?
I’d be happy to assist with creating a pull request to add these information if they can be provided.
The text was updated successfully, but these errors were encountered: