I am a new to KM and have been using it for the past 7 to 10 days (and have likely spent more time that I should have over my vacation learning and developing macros).
I think this is one of the best applications I have ever used. It does have a steep learning curve, it is more difficult for those with limited Apple Script / programming skills (like me), it is time consuming to create the macros, and it is very nuanced.
It is evolutionary, incremental (i.e., I find myself revisiting previous macros as my knowledge expands) and therefore time consuming, it is frustrating at times (i.e., I wish I the Fn key could be used a modifier key but understand why it is not), it requires thought, and more but, in the end and once built out and configured, it will be a game changer / huge time saver.
The assistance and support I have received is greatly appreciated and has kept me moving forward as I likely would have otherwise abandoned it.
Two items I would like to see added are as follows:
Ability to have subfolders to help organize macro groups. I know the suggested naming conventions that have been discussed (and I use them) but still, subfolders would be great!
Ability to have two opened macros side by side (perhaps this is possible but I have not figured out how). This would be helpful when developing similar but slightly different macros, reviewing logic of dependent macros, etc.
This has been suggested before (quite a few times), and it's not something that's ever likely to happen. An alternative to naming schemes are the smart groups, and that's how I organize many of my macros, based on a comment in each macro with a string that won't ever show up in the macros themselves. •—work—•, •—public—•, •—financial—•, etc. whatever, then create a smart group that searches for that string (or a combination of strings).
File → New Editor Window is a pretty good way to do this.
For me, as long as I don't accidentally open the same macro in more than one window, then the speed is fine—though I never have more than three open, so I can't say what it's like with more than that.
But I certainly know right away if I've accidentally opened the same macro in two windows; it gets so slow as to be unusable.
This may or may not meet your needs. Check out Edit→Copy As..
You can copy the selected macro as text or an image and then print that. For documenting macros you may want to disable “edit” mode (button on the bottom bar below the macro actions) to simplify the output.