2018-06-12 07:52:55 +09:00
|
|
|
# Contributing
|
|
|
|
|
|
|
|
|
|
Whether you have a question, an issue, a feature request, or desire to help out
|
|
|
|
|
with the software engineering, `go-fed` welcomes you!
|
|
|
|
|
|
|
|
|
|
## Table of Contents
|
|
|
|
|
|
|
|
|
|
1. Help, I have a question!
|
|
|
|
|
2. Help, I found a bug!
|
|
|
|
|
3. Whoa, I have a great idea!
|
|
|
|
|
4. Beep boop, I want to contribute code!
|
|
|
|
|
5. FAQ
|
2018-07-28 20:26:55 +09:00
|
|
|
6. Contributors
|
2018-06-12 07:52:55 +09:00
|
|
|
|
|
|
|
|
## I have a question!
|
|
|
|
|
|
|
|
|
|
The issues section of the repositories is generally **not** the place to ask
|
|
|
|
|
questions. However, it is worth checking the
|
|
|
|
|
[existing issues](https://github.com/go-fed/activity/issues?q=is%3Aissue) to see
|
|
|
|
|
if an existing bug or feature request provides enough context to answer the
|
|
|
|
|
question.
|
|
|
|
|
|
|
|
|
|
For direct support, the best way to engage is to reach out on the Fediverse
|
|
|
|
|
(such as on [Mastodon](https://joinmastodon.org/)) to `@cj@mastodon.technology`.
|
|
|
|
|
That will be a direct communication to myself and will provide visibility to
|
|
|
|
|
others who are invested in the ActivityPub Fediverse.
|
|
|
|
|
|
|
|
|
|
In the future, there will be a website hosting better documentation and a
|
|
|
|
|
tutorial for this library. My apologies that it is not available at this time.
|
|
|
|
|
|
|
|
|
|
## I found a bug!
|
|
|
|
|
|
|
|
|
|
The issues section is made just for you! Please check the
|
|
|
|
|
[existing issues](https://github.com/go-fed/activity/issues?q=is%3Aissue) to see
|
|
|
|
|
if it has already been filed. If not, please file a new one with the
|
|
|
|
|
[`bug` issue label](https://github.com/go-fed/activity/issues/new?template=bug-report-template.md&labels=bug).
|
|
|
|
|
|
|
|
|
|
## I have a great idea!
|
|
|
|
|
|
|
|
|
|
The issues section is made just for you! Please check the
|
|
|
|
|
[existing issues](https://github.com/go-fed/activity/issues?q=is%3Aissue) to see
|
|
|
|
|
if the idea has already been proposed. If not, please file a new one with the
|
|
|
|
|
[`feature request` issue label](https://github.com/go-fed/activity/issues/new?template=feature-request-template.md&labels=feature%20request).
|
|
|
|
|
|
|
|
|
|
## I want to contribute code!
|
|
|
|
|
|
|
|
|
|
Great! Please start participating in discussions on various bugs and feature
|
|
|
|
|
requests. For more casual discussions, reach out on the Fediverse at
|
|
|
|
|
`@cj@mastodon.technology`.
|
|
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
|
|
|
|
Here's a list of common or known issues.
|
|
|
|
|
|
|
|
|
|
### Do you accept contributors?
|
|
|
|
|
|
|
|
|
|
Yes!
|
|
|
|
|
|
|
|
|
|
### Compilation of `vocab` is tough on time and resources!
|
|
|
|
|
|
2018-06-14 06:23:46 +09:00
|
|
|
The `vocab` and `streams` packages are code generated on order of hundreds of
|
|
|
|
|
thousands to a million lines long. If using Go 1.9 or before, use `go install`
|
|
|
|
|
or `go build -i` to cache the build artifacts and do incremental builds.
|
|
|
|
|
|
|
|
|
|
Additionally, see [#42](https://github.com/go-fed/activity/issues/42).
|
2018-06-12 07:52:55 +09:00
|
|
|
|
|
|
|
|
### Can I financially support this effort?
|
|
|
|
|
|
|
|
|
|
Donations are strictly viewed as tips and not work-for-hire:
|
|
|
|
|
|
|
|
|
|
* [cjslep](https://liberapay.com/cj/)
|
2018-07-28 20:26:55 +09:00
|
|
|
|
|
|
|
|
## Contributors To This Repository
|
|
|
|
|
|
|
|
|
|
In order of first commit contribution.
|
|
|
|
|
|
|
|
|
|
* cjslep
|
|
|
|
|
* 21stio
|
