<p>In <a href="https://github.com/geany/geany/pull/629#discussion_r40381379">doc/plugins.dox</a>:</p>
<pre style='color:#555'>> +item2 = Bar
> +
> +[Help]
> +text = I'm a simple test. Nothing to see!
> +
> +[Info]
> +name = Demo Proxy Tester
> +description = I'm a simple test. Nothing to see!
> +version = 0.1
> +author = The Geany developer team
> +@endcode
> +
> +The first line acts as a verification that this file is truly a sub-plugin. Within the [Init] section
> +there is the menu items for Geany's tools menu. The [Help] section declares the sub-plugins help
> +text which is shown in its help dialog (via GeanyPluginFuncs::help). The [Info] section is
> +used as-is for filling the sub-plugins PluginInfo fields.
</pre>
<p>I would make this a list with each section a list item rather than one paragraph.</p>

<p>"The [Init] section contains the menu items ..." would be better English.</p>

<p>What is the number after item? Is it the position in the menu?  Is it just a meaningless variation so the keys are different, in which case maybe it would maybe be better as a list rather than separate items, do mnemonic underscores work?</p>

<p>What do you mean "as-is" for the info section? </p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br>Reply to this email directly or <a href="https://github.com/geany/geany/pull/629/files#r40381379">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/ABDrJ2YtqJVoDdmHHUGnoymi-RXhxaMMks5o1HDAgaJpZM4Fy7fG.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/geany/geany/pull/629/files#r40381379"></link>
  <meta itemprop="name" content="View Pull Request"></meta>
</div>
<meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>