Document 'divided' option

[avalanchy]

By looking at the template source code, I find out that we have forgotten option to create a horizontal rule between options. Here I repaired it and documented it. I also allowed myself to rename it to "divider" as this name seems to better explain the role. On the other hand, I can at this point break the backward compatibility. What do you think?

[andybak]

It wasn't actually broken before - just undocumented and maybe unintuitive!

The idea is that you add the property 'divided' to any menu item and it creates a horizontal rule before itself. Hence the use of the word 'divided' and the way the if/else was constructed in the template.

I actually prefer your solution but I'm a bit wary of breaking backwards compatibility.

I guess our options are:

1. Support both for perpetuity.
2. Switch to your syntax after a deprecation period with a warning.
3. Stick to the current method and document it.

What do you think?

[avalanchy]

Yup, it is a bit unintuitive - that's why I created the "divider" :) But with its usage documented - no one should have troubles with using it.

I tested the existing implementation and yeah, it works fine!

I allowed myself to force push the branch with the different commit that only updates documentation. I don't really wanna add support for both options since they will not give extra value to this plugin and most probably instead of bringing simpler API, will complicate the source code.

[andybak]

I'm happy with that.

[avalanchy]

Cool. Thanks.