Write bug report, feature request and code contribution guides
ClosedPublic
Actions

Authored by epriestley on Oct 30 2014, 8:40 PM.

Details

Reviewers

btrahan
chad

Maniphest Tasks

Commits

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.

Repository

rP Phabricator

Branch

utf4

Lint

Lint Passed

Unit

No Test Coverage

Build Status

Buildable 2920
Build 2924: [Placeholder Plan] Wait for 30 Seconds

epriestley retitled this revision from to Write bug report, feature request and code contribution guides.

epriestley updated this object.

epriestley edited the test plan for this revision. (Show Details)

awesometown

src/docs/contributor/contributing_code.diviner
230	Badge Awarded
src/docs/contributor/feature_requests.diviner
40	I like iron fist, but might come off harsh?

Yeah, I think the tone on that "iron fist" section could use a bit of pruning back in general, it comes off as a bit intense.

Something like 'in a strict, focused manor'?

chad removed a project: Badge Awarded.

I am also a big fan of these docs... =D

src/docs/contributor/bug_reports.diviner
133	does this end up being clickable?
src/docs/contributor/contributing_code.diviner
16	can you link CLA to the CLA?
src/docs/contributor/feature_requests.diviner
40	"We acknowledge this model is better at some things and worse at some things than a more community-focused model." (I think we're good here without adding more?)
124	link T4778