Page MenuHomePhabricator

Write bug report, feature request and code contribution guides
ClosedPublic

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

Details

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.

Diff Detail

Repository
rP Phabricator
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

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)
epriestley added reviewers: btrahan, chad.
chad added a project: Badge Awarded.

awesometown

src/docs/contributor/contributing_code.diviner
231
src/docs/contributor/feature_requests.diviner
41

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.

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

src/docs/contributor/bug_reports.diviner
134

does this end up being clickable?

src/docs/contributor/contributing_code.diviner
17

can you link CLA to the CLA?

src/docs/contributor/feature_requests.diviner
41

"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?)

125

link T4778

chad edited edge metadata.
This revision is now accepted and ready to land.Oct 31 2014, 5:08 PM
epriestley edited edge metadata.
  • Soften "iron fist".
  • Address inlines.
  • Put these in a separate section so they don't show up above the intro doc.
This revision was automatically updated to reflect the committed changes.