It can be used for tutorials, user guides, project documentation etc.
http://www.lishman.com/project/185#card/451 introduces the concept.
http://www.lishman.com/project/185#card/454/file/7997 provides an example of how it can be used.
http://blog.lishman.com/ has some more information about the application.
Any feedback would be very much appreciated.
Introduces the concept. http://www.lishman.com/project/185#card/451
Provides an example of how it can be used. http://www.lishman.com/project/185#card/454/file/7997
Some more information about the application. http://blog.lishman.com
I didn't see this feature, although I'm sure you've thought of it, but it would be nice to be able to point to and highlight specific lines of code, with arrows and color, to lead the reader from the annotation on the right to the code on the left.
If you or your users could document some popular open source projects, and prove that that's an efficient way to learn something, that will help the adoption.
Also, you mention about proving that it is an efficient way to learn. That's a good point. Rather than assuming that people will like the format I should try to prove that it works, maybe by providing a comparison with some existing documentation.
Thanks wanghq.