search

boakley / robotframework-hub

Web app for accessing robot framework assets
https://github.com/boakley/robotframework-hub/wiki
Apache License 2.0
170 stars 60 forks source link

Allow custom sorting or subdividing of keywords in a library #60

Open ewortzman opened 8 years ago

ewortzman commented 8 years ago

I have a library that contains about 40 keywords, but the keywords can be grouped into smaller groups. For example:

Protocol Library

Keyword Arguments Documentation
Close Type1 Session session close a Type1 session
Close Type2 Session session close a Type2 session
Close Type3 Session session close a Type3 session
Open Type1 Session *varags open a Type1 session
Open Type2 Session *varags open a Type2 session
Open Type3 Session *varags open a Type3 session
Update Type1 Session session, *varargs update a Type1 session
Update Type2 Session session, *varargs update a Type2 session
Update Type3 Session session, *varargs update a Type3 session

It doesn't really make sense to break these into separate libraries because there really aren't many cases where you would need one but not the others. It also doesn't make sense to try to combine them into common keywords because the different session types take different arguments.

It would make more sense to organize the table such that the Type1 keywords are grouped together, then Type2, then Type3. It would be nice if I could force this somehow, rather than them always being sorted alphabetically by default. Ideally, the Protocol Library

I know this isn't supported by libdoc, but it would be a nice enhancement.