Arduino file heiarchy documentation

I'm very afraid that it will eventually be "adapt or die". See below quote that seems to be pointing in that direction.

From that perspective I'm so glad that I'm living in an AVR world.