more documentation, better table example formatting