we could include a more detailed description for the table (more than the 1-liner) and force folks to write those implementation decisions there