Good question! First, this kind of comment block would replace the line I'm (hah) commenting on on this pull request. 

so it would be

```javascript
/**
 * for POSTed call parameters
 */
```
instead of 
```javascript 
// for POSTed call parameters
```

Secondly, I was trying to say that if you want to write details about a section, you can do it in the same block as the section's name.