move allocateIds to request & generate docs.

This comment structure is now recognized by our docs generator.

```js
//-
// Blah blah blah.
//-
function code() {};

//-
// More blah
//-
function blah();
```

is converted to...
```html
<p>Blah blah blah</p>
<code hljs language="javascript">function code() {};</code>
<p>More blah</p>
<code hljs language="javascript">function blah() {};</code>
```

(the code blocks are syntax highlighted)