I think each directory structures would benefit of having their own README with a more elaborate description along with pros/cons.