Source Code Overview

Question

I wrote an open-source board game implementation. The current state is in alpha. The idea is to have a stable, well-designed OO API to facilitate future extensions (bots, game options, and other user interface implementations). Thus, the more stable the API, the more stable / future.

After some time, developing on this, I think that each encoder develops a certain form of tunneling vision (at least I think I know). That I cannot improve the API: at its core, I cannot have a “fresh” look at it.

What a good way to attract people to thoroughly analyze the code and stabilize this API? Are there any websites that Google has not provided to me for this?

Answer 1

Have you tried Code Review ? This is the whole purpose of the site. :)

Answer 2

I think it’s quite difficult to get other developers to simply do code reviews — at first, there are enough active users; but it’s hard to get others to contribute. So this is a bit of a boot issue. I would suggest that I am actually trying to come up with the ok API and accept the fact that it is unlikely to remain unchanged. Then make others join; The project should be interesting in itself.

In fact, I would not worry so much about future API validation; you would rather want to plan to make it less painful, and then use an extreme approach. Change as soon as possible, but always keep things in working order.

So: it’s good to have the tools available to view the code: but the real problem is that people spend a considerable amount of time to learn enough to be able to view.

Answer 3

Possibly Rietveld code verification tool

http://code.google.com/appengine/articles/rietveld.html

here is an example http://codereview.appspot.com/

Of course, you can run your own instance!

but its hard to get others to revise the code, you need some tools for this.

But basically you need to do advertising on social networks, I mean, to visit the developer community and invite them to try their work, create a Twitter account for your project, facebook page, blog, etc. So you offer another - a door to go through and see.

if you look, they will help you

Answer 4

I remember Jeff mentioning this in the old StackOverflow podcast (but I haven't tried it myself):

http://refactormycode.com/