Difference between revisions of "SOC Writing Project Proposals"

From Inkscape Wiki
Jump to navigation Jump to search
Line 51: Line 51:
* http://www.internet2.edu/~shalunov/writing/soc2005.html
* http://www.internet2.edu/~shalunov/writing/soc2005.html

[[Category:Developer Documenation]]
[[Category:Developer Documentation]]

Revision as of 16:20, 21 June 2006

Writing Project Proposals

If you're thinking about writing a proposal for one of the Google Summer of Code projects, you might be uncertain about a few things. How big of a task should you propose? What should you include in your proposal? How can you make it more acceptable?

Of course, you will have to decide the answers to these questions with your own judgement, but on this page are some suggestions that may give you some inspiration.

Don't Bite Off More Than You Can Chew

Remember that this effort is date-scoped. This is a little unusual for Open Source projects, but is common for contract work. But don't panic, there are some techniques to ensure you will succeed at achieving this.

First, be very careful about what you commit to delivering. If possible, try to pick things that you already know how to do pretty well and won't need to do a lot of learning and research. This way, you'll be less likely to find yourself halfway done and realizing you've bitten off WAY more than you can chew. Of course, you can probably list some "optional" delivery items for things you're less certain about.

Second, try to weight your schedule to get the key portion of the project done as early as possible. In other words, try to do 80% of the coding in the first 20% of the time. The reason for this is that the last 20% of the project often seems to take 80% of the time (no one really knows why, it just always works out that way.) So try to set your schedule up so that you "should be done" within 2-3 weeks; that way when reality sets in and it takes 2-3 months, you're not totally screwed.  ;-)

There's More to Open Source Than Coding

It's very common to assume that most of the work of implementing a new feature is just writing code. Sometimes that is in fact the case, but it's much more common that the coding is just a small part of the effort.

Since the purpose of Google's sponsorship is to increase your knowledge of Open Source, make sure your project includes these other kinds of activities:

  • Survey the Open Source world to see if anyone else has done something like your feature; if so, analyze what they did, and borrow ideas and algorithms from it
  • Create good code documentation for code affected by the change
  • Create a tutorial that shows users how to use the new feature
  • Solicit users to test out your new feature, and encourage them to submit bug reports and feature requests. Triage which of these you can do, and do them.
  • Write a short article for an online publication about your work

More Links