It'd be neat if Phabricator had github-style previews for checked-in docs (in markdown, remarkup, or really anything rich).
should have the utility of something like this:
This has a couple of wins:
- Simple documentation can easily be reviewed with the rest of code (on content and formatting!)
- Documentation is much more likely to be consistent on a commit-by-commit basis with the systems it's documenting.
- 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.