X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=docs%2Fhelpwanted.html;h=859e65c88b18efd6df05236cfd30d69d6c048ffb;hb=c4fd0c9052dd391d6f2e9bb8e6da209dfc7ef35b;hp=b9434d0c03460795b67ffebcf5ee610b25d68507;hpb=0b27aceae2464db3dd149cf4fd667e353a655c5e;p=mesa.git diff --git a/docs/helpwanted.html b/docs/helpwanted.html index b9434d0c034..859e65c88b1 100644 --- a/docs/helpwanted.html +++ b/docs/helpwanted.html @@ -1,62 +1,105 @@ - + + + + + Help Wanted + + + -Help Wanted +
+

The Mesa 3D Graphics Library

+
- + +
-

Help Wanted

+

Help Wanted / To-Do List

-We can always use more help with the Mesa project. Here are some -specific areas. If you think you can help out, post to the mesa3d-dev -mailing list. +We can always use more help with the Mesa project. +Here are some specific ideas and areas where help would be appreciated:

- - +
    +
  1. +Driver patching and testing. +Patches are often posted to the mesa-dev mailing list, but aren't +immediately checked into git because not enough people are testing them. +Just applying patches, testing and reporting back is helpful. +
  2. +Driver debugging. +There are plenty of open bugs in the bug database. +
  3. +Remove aliasing warnings. +Enable gcc -Wstrict-aliasing=2 -fstrict-aliasing and track down aliasing +issues in the code. +
  4. +Windows driver building, testing and maintenance. +Fixing MSVC builds. +
  5. +Contribute more tests to +Piglit. +
  6. +Automatic testing. + +It would be great if someone would set up an automated system for grabbing +the latest Mesa code and run tests (such as piglit) then report issues to +the mailing list. +

-If you want to help with Mesa, first join the Mesa developer's -mailing list. Then post a message explaining what you might like -to help with. The Mesa web page has a list of a few work items -which you may consider. +You can find some further To-do lists here:

+

+Common To-Do lists:

-Anyone is welcome to contribute code to the Mesa project, provided you -agree to the copyright terms of the relevant code. See the COPYRIGHT -file. + + +

+Driver specific To-Do lists:

+

-Unfortunately, all the easy work in Mesa was done years ago. Nowadays, the -work is rather complicated and not suited to beginners. +If you want to do something new in Mesa, first join the Mesa developer's +mailing list. +Then post a message to propose what you want to do, just to make sure +there's no issues.

-If you're contribution code to the Mesa library itself: +Anyone is welcome to contribute code to the Mesa project. +By doing so, it's assumed that you agree to the code's licensing terms. +

+

-

    -
  1. Try to write clean code (uniform indentation, comments, meaningful - identifiers, etc). It must be readable and maintainable! +Finally: +

    -
  2. Test your code. On several occations I've incorporated code from - users which later turned out to have bugs. Now, I'm pretty hesitant - to use code which doesn't look good. +
      +
    1. Try to write high-quality code that follows the existing style. +
    2. Use uniform indentation, write comments, use meaningful identifiers, etc. +
    3. Test your code thoroughly. Include test programs if appropriate.
    - - - +
+ +