GCI2010: Difference between revisions

From flashrom
Jump to navigation Jump to search
Line 35: Line 35:


=Documentation: Tasks related to creating/editing documents=
=Documentation: Tasks related to creating/editing documents=
==Collect tutorials on the web, move them to flashrom.org==
Find tutorials and useful blog posts about flashrom, then ask the authors if we may reproduce/edit the content on flashrom.org. All documentation should be in a central place.
==Write a tutorial on how to use flashom==
We have an exhaustive man page, but many people can't read man pages. They need some handholding and simple examples they can copy-and-paste without thinking. Help them use flashrom.
==Document the requirements for sending patches==
This document should already be on the wiki. Locate it, check the style and readability, and extend it.
==Document how flashrom is structured internally==
The usual call paths are quite important, and especially with libflashrom we need to tell people how to use the code.
==Provide translations of code==
flashrom messages can be translated, but deciding which messages to translate is hard. Identify a suitable subset of messages, make sure developers agree, then find out how to best integrate translated messages in flashrom. Hint: cli_output.c can be used for this.
==Provide translations of Howtos, tutorials, the man page==
Translate those docs, and make sure to clearly state which version of the original document they are based on.
=Outreach: Tasks related to community management and outreach/marketing=
=Outreach: Tasks related to community management and outreach/marketing=
=Quality Assurance: Tasks related to testing and ensuring code is of high quality=
=Quality Assurance: Tasks related to testing and ensuring code is of high quality=

Revision as of 00:14, 31 October 2010

We hope to participate in Google Code-in 2010 (basically Google Summer of code for 13-18 year old students)

Please note that the task list is not finished, and we will add more tasks once we know how long individual tasks are supposed to take.

Code: Tasks related to writing or refactoring code

Add all chips listed in flashchips.h to flashchips.c

This means you have to find the datasheet for each chip (ask us, we have a huge datasheet archive), compare it with some already supported chip, then add struct flashchip for the new chip to flashchips.c.

Estimated time depends on your datasheet reading skills, and is between 5 minutes and 2 hours per chip.

Add all chips supported by the Linux MTD layer to flashchips.c

Given that the Linux MTD code and flashrom are GPLv2, copy-paste is OK, but keep in mind that the data structures differ and that the Linux MTD chip definitions have less info about erase methods than flashrom. OTOH, some info in Linux MTD chip defintions is not (yet) present in flashrom, so you may have to carry some useful info forward as comments. You will have to look up the datasheet for each chip as with the task above.

Compare Ezoflash support list with flashrom support list, add missing chips to flashchips.c

Find the datasheets, etc. For more info, see the tasks above.

Compare Willem/... support list with flashrom support list, add missing chips to flashchips.c

See above.

Finish the flashrom Qt GUI

Sean Nelson wrote a Qt GUI for the flashrom executable, but it needs to be finished and extended to take advantage of all flashrom features.

Convert the flashrom Qt GUI to use libflashrom

For some applications libflashrom is preferable to a flashrom executable. Investigate which variant makes more sense.

Create a Windows GUI for flashrom

Check if the existing Qt GUI can be reused or if flashrom needs a totally separate native Windows GUI.

Add comments before each function

Document the parameters taken by the function, the return value and what the function does.

Finish libflashrom

This task is REALLY hard. Help us find a good and maintainable library interface for flashrom which is still usable 2 years from now. It is strongly suggested that you have some experience with library programming and/or creating stable interfaces.

Documentation: Tasks related to creating/editing documents

Collect tutorials on the web, move them to flashrom.org

Find tutorials and useful blog posts about flashrom, then ask the authors if we may reproduce/edit the content on flashrom.org. All documentation should be in a central place.

Write a tutorial on how to use flashom

We have an exhaustive man page, but many people can't read man pages. They need some handholding and simple examples they can copy-and-paste without thinking. Help them use flashrom.

Document the requirements for sending patches

This document should already be on the wiki. Locate it, check the style and readability, and extend it.

Document how flashrom is structured internally

The usual call paths are quite important, and especially with libflashrom we need to tell people how to use the code.

Provide translations of code

flashrom messages can be translated, but deciding which messages to translate is hard. Identify a suitable subset of messages, make sure developers agree, then find out how to best integrate translated messages in flashrom. Hint: cli_output.c can be used for this.

Provide translations of Howtos, tutorials, the man page

Translate those docs, and make sure to clearly state which version of the original document they are based on.

Outreach: Tasks related to community management and outreach/marketing

Quality Assurance: Tasks related to testing and ensuring code is of high quality

Research: Tasks related to studying a problem and recommending solutions

Training: Tasks related to helping others learn more

Translation: Tasks related to localization

User Interface: Tasks related to user experience research or user interface design and interaction