mirror of
https://we.phorge.it/source/phorge.git
synced 2024-12-01 03:02:43 +01:00
853588af89
Summary: Fixes T6347. This refines the "contributor guide" documents to basically lock down support further. Notable changes in policy: - Bugs: Emphasis on reproduction steps, strong emphasis on using Maniphest. Emphasis on what we support. - Features: Emphasis on describing problems instead of solutions, emphasis on realistic expecations about timelines. Strong emphasis on using Maniphest. - Code: Strong emphasis on coordinating with us first. No GitHub pull requests. Emphasis on us ignoring contributions we don't have time to deal with. Suggests local forks. Test Plan: Read these through; let me generate them and take some screenshots for easier reading. Reviewers: btrahan, chad Reviewed By: chad Subscribers: epriestley Maniphest Tasks: T6347 Differential Revision: https://secure.phabricator.com/D10764
70 lines
3.3 KiB
Text
70 lines
3.3 KiB
Text
@title Contributor Introduction
|
|
@group contrib
|
|
|
|
Introduction to contributing to Phabricator, Arcanist and libphutil.
|
|
|
|
Overview
|
|
========
|
|
|
|
If you'd like to contribute to Phabricator, this document can guide you though
|
|
ways you can help improve the project.
|
|
|
|
Writing code is valuable, but often isn't the best or easiest way to contribute.
|
|
In most cases we are pretty good at fixing easy stuff quickly, so we don't have
|
|
a big pile of easy stuff sitting around waiting for new contributors.
|
|
|
|
This can make it difficult to contribute code if you only have a little bit of
|
|
time to spend since most of the work that needs to be done usually requires some
|
|
heavy lifting.
|
|
|
|
Without writing any code, learning the whole codebase, making a big time
|
|
commitment, or having to touch PHP, here are some ways you can materially
|
|
contribute to Phabricator:
|
|
|
|
- Send us an email or drop by IRC just to say "thanks". A big part of the
|
|
reason we build this software is to help people solve problems, and knowing
|
|
that our efforts are appreciated is really rewarding. You can find ways to
|
|
get in touch in @{article:Give Feedback! Get Support!}
|
|
- Recommend Phabricator to people who you think might find it useful. Our
|
|
most powerful growth channel is word of mouth, and mentioning or tweeting
|
|
about Phabricator helps the project grow. If writing a tweet sounds like
|
|
too much work, you can use one of these form tweets written by our PR
|
|
department to quickly and easily shill on our behalf. Hail corporate!
|
|
|
|
> Phabricator seems like it's pretty okay
|
|
|
|
> I am not being paid to mention Phabricator in this extemporaneous, completely organic tweet
|
|
|
|
> Phabricator is objectively the best thing. Source: I am a certified, internationally recognized expert.
|
|
|
|
- Report bugs and request features. We may not always be able to fix or build
|
|
things right away, but knowing about issues users are encountering or
|
|
features they'd like to see improves our ability to plan and prioritize.
|
|
For ways to do this, see @{article:Give Feedback! Get Support!}
|
|
- For details on reporting bugs, see @{article:Contributing Bug Reports}.
|
|
- For details on requesting features, see @{article:Contributing Feature
|
|
Requests}.
|
|
- Give us feedback on planned features. Most of what we'll build in the next
|
|
6-12 months currently exists on the [[ Roadmap ]] or in Maniphest. Telling
|
|
us about use cases you have can help us build better products when the time
|
|
comes to write the code.
|
|
- Hang out in IRC, and maybe answer a question or two. IRC is a completely
|
|
legit place for serious hackers to hang out anyway, but while you're there
|
|
you might see someone ask a question that you know the answer to. Helping
|
|
them out (or pointing them to the right documentation) is a big help to us.
|
|
You can find details about the IRC channel in
|
|
@{article:Give Feedback! Get Support!}
|
|
|
|
If all of this sounds nice but you really just want to write some code, that's
|
|
awesome too. To get started with contributing code, see
|
|
@{article:Contributing Code}.
|
|
|
|
Next Steps
|
|
==========
|
|
|
|
Continue by:
|
|
|
|
- learning about bug reports in @{article:Contributing Bug Reports};
|
|
- learning about feature requests in @{article:Contributing Feature Requests};
|
|
- learning about code contributions in @{article:Contributing Code}; or
|
|
- getting in touch with @{article:Give Feedback! Get Support!}
|