That's a great idea too. But here's why it's a good idea to propose a gist of this file as well:

  *  Removes any ambiguity of how you see the forthcoming documentation applying here
  *  Opens the door for us to discuss the application of that style here

In other words, by having this discussion documented in the *specific case* first, it may end up both improving and speeding the work on the *general* documentation afterwards.