Merged file format & specification

Also changed the types to simpler words to avoid confusion
Clarify master file specification

 - doc folder
 - distribution cache
Added status to repositories in distribution file

Also gave reference API implementation
Fixed examples and test file spec
Added admin-notification to build file

also fixed example titles
Added references