<blockquote>
<p>I fear that also makes it less useful to newcomers that aren't used to the schema.</p>
</blockquote>

<p>I'd prefer to see it at the top, but I'm not sure if that's just my familiarity. I use annotate on many other projects, all top-annotated, and when I'm not interested in the details, I find it easy to ignore (like ignoring big license blurbs at the top of files :-) ). Here's a large project that I use it with, for example: <a href="https://github.com/cyclestreets/cyclescape/tree/staging/app/models">https://github.com/cyclestreets/cyclescape/tree/staging/app/models</a></p>

<p>But top or bottom is just a detail. Having it is, as <a href="https://github.com/zere" class="user-mention">@zere</a> says, much easier than fishing around via psql to see what attributes are available on each model, especially given our confusing model vs table naming differences, and attributes that appear neither in the models nor the model tests.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/openstreetmap/openstreetmap-website/pull/1280#issuecomment-245904853">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/ABWnLf2LNinMim7MwkHIhs0Jbn3iinh-ks5qoVd5gaJpZM4J4usV">mute the thread</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABWnLTbAs1jnakHTGkoFrK9Kh7ZjirWcks5qoVd5gaJpZM4J4usV.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
<div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
  <link itemprop="url" href="https://github.com/openstreetmap/openstreetmap-website/pull/1280#issuecomment-245904853"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>

<script type="application/json" data-scope="inboxmarkup">{"api_version":"1.0","publisher":{"api_key":"05dde50f1d1a384dd78767c55493e4bb","name":"GitHub"},"entity":{"external_key":"github/openstreetmap/openstreetmap-website","title":"openstreetmap/openstreetmap-website","subtitle":"GitHub repository","main_image_url":"https://cloud.githubusercontent.com/assets/143418/17495839/a5054eac-5d88-11e6-95fc-7290892c7bb5.png","avatar_image_url":"https://cloud.githubusercontent.com/assets/143418/15842166/7c72db34-2c0b-11e6-9aed-b52498112777.png","action":{"name":"Open in GitHub","url":"https://github.com/openstreetmap/openstreetmap-website"}},"updates":{"snippets":[{"icon":"PERSON","message":"@gravitystorm in #1280: \u003e I fear that also makes it less useful to newcomers that aren't used to the schema.\r\n\r\nI'd prefer to see it at the top, but I'm not sure if that's just my familiarity. I use annotate on many other projects, all top-annotated, and when I'm not interested in the details, I find it easy to ignore (like ignoring big license blurbs at the top of files :-) ). Here's a large project that I use it with, for example: https://github.com/cyclestreets/cyclescape/tree/staging/app/models\r\n\r\nBut top or bottom is just a detail. Having it is, as @zere says, much easier than fishing around via psql to see what attributes are available on each model, especially given our confusing model vs table naming differences, and attributes that appear neither in the models nor the model tests."}],"action":{"name":"View Pull Request","url":"https://github.com/openstreetmap/openstreetmap-website/pull/1280#issuecomment-245904853"}}}</script>