HN Explorer

Ask HN: Review my startup, lishman.com

6 points by lishy ↗ HN
lishman source is a platform for describing and annotating real source code.

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.

6 comments

[ 3.1 ms ] story [ 28.8 ms ] thread
kohanz
I like the concept. This would be especially useful for documenting ramp-up guides for new developers.

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.

wanghq
I am not sure if you have provided, but could imagine the integration with github should be very useful.

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.

lishy
Integrating with version control systems, such as git, is quite high on my list of things to do (but it's a big list). My next move is to try and get other users to add their content onto the website, and github seems like an excellent place to start.

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.