Change Details

It'd be neat if Phabricator had github-style previews for checked-in docs (in markdown, remarkup, or really anything rich). For example: https://secure.phabricator.com/diffusion/P/browse/master/README should have the utility of something like this: https://github.com/less/less-docs/blob/master/README.md This has a couple of wins: 1. Simple documentation can easily be reviewed with the rest of code (on content and formatting!) 2. Documentation is much more likely to be consistent on a commit-by-commit basis with the systems it's documenting. 3. It's easy to make the world's simplest wiki. We could just add a param to the URL to specify pretty formatting. Also, integrating Github-flavored markdown would make life easier for those of us who work in both universes regularly. Happy to make a separate task for that.

It'd be neat if Phabricator had github-style previews for checked-in docs (in markdown, remarkup, or really anything rich). For example: https://secure.phabricator.com/diffusion/P/browse/master/README.md should have the utility of something like this: https://github.com/less/less-docs/blob/master/README.md This has a couple of wins: 1. Simple documentation can easily be reviewed with the rest of code (on content and formatting!) 2. Documentation is much more likely to be consistent on a commit-by-commit basis with the systems it's documenting. 3. It's easy to make the world's simplest wiki. We could just add a param to the URL to specify pretty formatting. Also, integrating Github-flavored markdown would make life easier for those of us who work in both universes regularly. Happy to make a separate task for that.

It'd be neat if Phabricator had github-style previews for checked-in docs (in markdown, remarkup, or really anything rich). For example: https://secure.phabricator.com/diffusion/P/browse/master/README.md should have the utility of something like this: https://github.com/less/less-docs/blob/master/README.md This has a couple of wins: 1. Simple documentation can easily be reviewed with the rest of code (on content and formatting!) 2. Documentation is much more likely to be consistent on a commit-by-commit basis with the systems it's documenting. 3. It's easy to make the world's simplest wiki. We could just add a param to the URL to specify pretty formatting. Also, integrating Github-flavored markdown would make life easier for those of us who work in both universes regularly. Happy to make a separate task for that.