Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Contributor Setup Guide for OpenTelemetry Protocol with Apache Arrow #281

Open
RichardChukwu opened this issue Jan 22, 2025 · 0 comments · Fixed by RichardChukwu/otel-arrow#1 · May be fixed by #282
Open

Improve Contributor Setup Guide for OpenTelemetry Protocol with Apache Arrow #281

RichardChukwu opened this issue Jan 22, 2025 · 0 comments · Fixed by RichardChukwu/otel-arrow#1 · May be fixed by #282

Comments

@RichardChukwu
Copy link

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:

  1. 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).

  1. 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.

  1. 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).

  1. 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.

  1. 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
1 participant