Re: Api doc categories

2013-08-22 Thread Marcus Sorensen
I've confirmed that mismatches can happen, for example if you say both VPN and VPC in an api name. It would be nice to have an explicit annotation for doc category. On Thu, Aug 22, 2013 at 10:41 AM, Marcus Sorensen wrote: > Thanks, in looking through the mail history, I can see various > suggesti

Re: Api doc categories

2013-08-22 Thread Marcus Sorensen
Thanks, in looking through the mail history, I can see various suggestions of adding categories to gen_toc.py, but I don't see a concrete explanation of how this works. In experimenting it seems that the category is matched against the api command name. That seems quite limiting from a third party

Re: Api doc categories

2013-08-22 Thread Daan Hoogland
Marcus, I recall a mail in this list where a naming convention was mentioned. Look along those lines for categories. regards, Daan On Thu, Aug 22, 2013 at 6:46 AM, Marcus Sorensen wrote: > I've spent a few minutes trying to figure out how API commands are linked > with their categories in the A

Api doc categories

2013-08-21 Thread Marcus Sorensen
I've spent a few minutes trying to figure out how API commands are linked with their categories in the API documentation. I read the doc about annotations and generating the docs. I see the known_categories in gen_toc.py, but I don't see any place in the annotations where one might define a specifi