[contrib] add note about files, folders and namespaces.
[contrib] fix markdown syntax.