> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Community and support

> Get help, report issues, and contribute to the connector ecosystem.

You're not alone in this. The Baton community is active and welcoming.

## Getting help

### GitHub discussions

The primary place for questions and discussions is GitHub:

| Repository                                                         | Use for                                      |
| ------------------------------------------------------------------ | -------------------------------------------- |
| [baton-sdk](https://github.com/conductorone/baton-sdk/discussions) | SDK questions, general connector development |
| Specific connector repos                                           | Issues with that connector                   |

Before asking:

1. Search existing issues and discussions
2. Check this documentation
3. Review the [recipes](/developer/recipes-auth) for common patterns

### What makes a good question

Include:

* What you're trying to accomplish
* What you've tried
* Error messages (full text, not screenshots)
* Relevant code snippets
* Connector version and target system

**Bad:** "My connector doesn't work"

**Good:** "Sync fails with 'unauthorized' error when listing users. Using baton-okta v0.5.2 with API token auth. Token has read\_users scope. Full error: \[paste error]"

### Support channels

| Channel            | Response time | Use for                                                 |
| ------------------ | ------------- | ------------------------------------------------------- |
| GitHub Issues      | Days          | Bugs, connector feature requests                        |
| GitHub Discussions | Days          | Questions, how-to help                                  |
| C1 Support         | Hours         | Production issues (customers), product feature requests |

## Reporting issues

### Bug reports

When reporting a bug, include:

| Information                  | Why it helps             |
| ---------------------------- | ------------------------ |
| Connector name and version   | Reproducibility          |
| Steps to reproduce           | Root cause analysis      |
| Expected vs actual behavior  | Understanding the issue  |
| Error messages               | Debugging                |
| Environment (OS, Go version) | Platform-specific issues |

**Template:**

```markdown theme={"theme":{"light":"css-variables","dark":"css-variables"}}
## Bug Report

**Connector:** baton-yourservice v1.2.3
**Environment:** macOS 14.0, Go 1.23

**Steps to reproduce:**
1. Configure connector with API key
2. Run `baton-yourservice --api-key $KEY`
3. Observe error

**Expected:** Sync completes successfully
**Actual:** Sync fails with error: [paste error]

**Logs:** (if helpful)
```

### Security issues

<Warning>
  **DO NOT** file security issues publicly.
</Warning>

Report security vulnerabilities to: [security@c1.ai](mailto:security@c1.ai)

Security researchers are publicly acknowledged for responsible disclosure.

## Contributing

### Quick contribution checklist

Before submitting a PR:

* Code follows SDK patterns
* Lint passes: `make lint`
* Tests pass: `make test`
* README documents required permissions
* No credentials in code or logs

### Contribution flow

1. Fork repository
2. Create feature branch
3. Make changes
4. Run local validation (build, lint, test)
5. Submit pull request
6. Address review feedback
7. Merge

See [Publishing](/developer/submit) for the complete contribution workflow.

## Code of conduct

The Baton ecosystem follows the [Contributor Covenant Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).

### Our pledge

We pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.

### Standards

**Positive behaviors:**

* Demonstrating empathy and kindness
* Being respectful of differing opinions
* Giving and gracefully accepting constructive feedback
* Accepting responsibility for mistakes and learning from them
* Focusing on what is best for the community

**Unacceptable behaviors:**

* Sexualized language or imagery
* Trolling, insulting, or derogatory comments
* Public or private harassment
* Publishing others' private information without permission
* Other conduct inappropriate in a professional setting

### Enforcement

Report violations to: [open-source@c1.ai](mailto:open-source@c1.ai)

All complaints will be reviewed and investigated promptly and fairly.

## Governance

### Decision making

The Baton ecosystem is maintained by C1 with community input.

| Decision type             | Who decides                  |
| ------------------------- | ---------------------------- |
| SDK changes               | C1 team                      |
| New connectors (C1 org)   | C1 team                      |
| New connectors (your org) | You                          |
| Feature requests          | Maintainers of affected repo |

### Roadmap

The project roadmap is tracked through GitHub issues in the [baton-sdk repository](https://github.com/conductorone/baton-sdk/issues).

Community members can:

* View open issues and planned features
* Comment on proposed changes
* Suggest priorities through issue labels

## Quick reference

### Key links

| Resource                | URL                                                                                    |
| ----------------------- | -------------------------------------------------------------------------------------- |
| baton-sdk               | [https://github.com/conductorone/baton-sdk](https://github.com/conductorone/baton-sdk) |
| Security Reports        | [security@c1.ai](mailto:security@c1.ai)                                                |
| Code of Conduct Reports | [open-source@c1.ai](mailto:open-source@c1.ai)                                          |

### Issue labels

| Label              | Meaning                         |
| ------------------ | ------------------------------- |
| `bug`              | Something isn't working         |
| `enhancement`      | New feature or improvement      |
| `documentation`    | Documentation improvements      |
| `good first issue` | Good for newcomers              |
| `help wanted`      | Maintainers want community help |
