write documentation for filename conventions and follow them