What's your plan with documentation - wiki or markdown files in source?

Google seems to document everything in repo - which is brilliant since it can be reviewed, you can ask PR author to update doc and hence less likely to go out of sync.