Page MenuHomePhabricator

Write a "Developer Setup" guide for onboarding
ClosedPublic

Authored by epriestley on Apr 9 2017, 11:58 AM.

Details

Summary

Fixes T11561. Collect guidance about local configuration which hasn't been obvious in the past.

Test Plan
  • Read document carefully.
  • Used ./bin/diviner generate to generate documentation.
  • Previewed in Diviner locally:

Screen Shot 2017-04-09 at 4.57.46 AM.png (1×2 px, 297 KB)

Diff Detail

Repository
rP Phabricator
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

cspeckmim added inline comments.
src/docs/contributor/developer_setup.diviner
55–56

Maybe it's obvious, but needing to restart the web service after modifying is typically necessary too.

Maybe it's obvious, but needing to restart the web service after modifying is typically necessary too.

It shouldn't be if you enable phabricator.developer-mode, then resolve any setup warnings. They should tune apc.stat and/or opcache.validate_timestamps/opcache.revalidate_freq appropriately for development (never require a restart) or production (improve performance).

Aha! That will simplify my dev setup/process

This revision is now accepted and ready to land.Apr 9 2017, 5:50 PM

Maybe something about lipsum

  • Add notes about bin/lipsum.
This revision was automatically updated to reflect the committed changes.