more documentation

44 views
Skip to first unread message

Maimonides

unread,
May 13, 2011, 7:29:47 PM5/13/11
to bitverse-unity-gui
Hi,
the project looks very fine, but it is in DESPERATE need of more docs.
No need to provide screenshots, just please spend 10 minutes writing
an asci text with documentation. Your previous reply about not having
time to provide documentation feels very offensive. If you want to
provide to the community, please go the last 5% and provide
documentation as well, otherwise all your efforts are in vain, as you
are much more likely to enrage people who start to experiment with it,
rather than anything else
regards

David

Ricardo Andere de Mello

unread,
May 13, 2011, 10:29:05 PM5/13/11
to bitverse-...@googlegroups.com
David, I will copy the email I answered in private to you here:
"Hi.... the project is not actually abandoned.... the main problem is that we are still activelly using it internally, and recently we did some changes that unfortunatelly appended some of our internal libraries.
Now he have to "detach" it again for a new release...
Another problem is that we used some injection tricks to get better performance, and we cant do this at the googlecode project, so we are deciding what to do. See, our performance optimization tricks broke the scrollbar, for example, and we used injection to make it work again.
I think we will have a better position in a couple of weeks, but dont expect more documentation... what I can try to do is a screencast, explaining better the library use.
[]s, Ricardo"


I understand that you need more documentation, but the real purpose of liberating to the "community" is to try to find people to document and help to develop it. Unfortunatelly we are not students, we have fulltime jobs, and actually, we only could release part of our code because the company we work allowed us to do so. The company dont want us giving more focus to the library than their own product, We just convinced them that liberating it could help to develop it.
So you can fork the code, document it, and make a better project and I would love this. :)

I have worked with OpenSource/Free Software for a long time and I understand that when I find code that say provided "as is" , everybody understands that this is not a final product, and any legal/damage responsability does not apply. It would be really easier for us to just shutdown the project and dont bother at all.

My tip is, use the pearls, find someone and try to help. Start by asking questions at the list, for us , creating a forum about it, and if someone make questions, give it back by answering them.

Unfortunatelly the library as a "Community Project" is still in its early stages, but if we find someone able to learn it and give some of his time, we will gladly pass the ball.

[]s, Ricardo.

2011/5/13 Maimonides <david...@gmail.com>
Reply all
Reply to author
Forward
0 new messages