Marble/GoMarble/JJ: Difference between revisions

    From KDE TechBase
    (Page moved to community wiki)
     
    (6 intermediate revisions by 4 users not shown)
    Line 1: Line 1:
    If you are new to Marble then you want to check this page. We list a few things you can do which are easy tasks and introduce you to Marble development.
    {{ Moved To Community }}
    You can possible find some Junior Jobs at [https://bugs.kde.org/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=marble&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=junior-jobs&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= KDE's Bugzilla].
     
    == Marble Marketing Junior Jobs ==
    Check
     
    [http://www.google.de/search?as_q=Marble+KDE&hl=de&num=100&btnG=Google-Suche&as_epq=&as_oq=&as_eq=&lr=&cr=&as_ft=i&as_filetype=&as_qdr=d&as_occt=any&as_dt=i&as_sitesearch=&as_rights=&safe=images "Marble KDE"] results of the last 24 hours
     
    for interesting news items related to Marble. Then post these news to our Marble [http://www.facebook.com/#!/group.php?gid=346064806033 "Marble Facebook group"]. In the next step update our [http://edu.kde.org/marble "Marble Website"] accordingly.
     
    == Quality Assurance / Documentation ==
    We want our <i>Marble source code to look good</i>. The <i>documentation should be concise and helpful</i> and the comments shouldn't have spelling errors. Also it shouldn't have any obvious "formal" bugs. Help us to improve our code quality. This is an easy job that helps you to get familiar with the source code. It's the first thing that absolute beginners usually want to look at. We list a few important issues that need to be checked for <i>regularly</i>:
     
    * Try to find <b>spelling errors</b> in the source code comments and in Marble UI strings. (EASY)
    * <b>KDE Krazy check</b>: Have a look at the results of the <i>static code checker</i>: http://www.englishbreakfastnetwork.org/krazy/reports/kde-4.x/kdeedu/marble/index.html. Try to understand possible problems and create a fix for them. (EASY/MEDIUM)
    * Get rid of <b>compile warnings</b>: Compile Marble from scratch and check all the warnings that possibly appear. Try to get rid of the warnings by adding fixes. If parameters are not used, examine why and either remove them or hide the warning or leave it as it is. (EASY-MEDIUM)
    * Compile marble with the cmake option <b>-DPEDANTIC=ON</b>. Fix all errors that come up until Marble compiles through (MEDIUM).
    * <b>Add comments</b>. You don't understand some source code in Marble? Then probably other people won't either. Try to understand it and ask Marble developers. The add some comments so that the next person will be able to understand the source code much easier (MEDIUM).
    * Create <b>API-Documentation</b> (EASY).
    * <b>Review the API</b>. Make sure that the API is Qt-ish (MEDIUM). Read http://qt.gitorious.org/qt/pages/ApiDesignPrinciples and read the Marble source code. Try to find cases which seem to be non-standard. (MEDIUM)
    * Read our <b>Marble Coding Standards</b>: http://websvn.kde.org/trunk/KDE/kdeedu/marble/CODING?revision=700337&view=markup. Ensure that the Marble source code follows it (EASY).
    * Help to <b>translate Marble into your own language</b>. Try to find "weird" translations or translations that don't express things in words that a normal user would understand and correct/report them (MEDIUM).
     
    * Check KDE's <b>Bugzilla</b> for any open Marble bugs: https://bugs.kde.org/buglist.cgi?quicksearch=Marble. Try to reproduce the bugs and check whether the bugs are still valid. Remove them if they're not valid anymore and seem to be fixed already (EASY). Try to fix them if they are still valid (MEDIUM/HARD).
     
    If you come across a problem don't hesitate to ask us (there are no stupid questions, just people who are afraid of asking for stupid reasons ;-)
    If you want to send in your patch for review, please send it to our mailing list [email protected].
     
     
    == Programmer Junior Jobs ==
    This section deals with junior jobs that require basic C++ skills:
     
     
    ===Let the "Open ..." file dialog remember the previously used directory===
     
    Marble should remember the previous directory used for the Open ... file dialog. This feature needs to be implemented for the KDE and Qt version of Marble.
     
    Level of difficulty: EASY
     
    ===Create an "Open Recent ..." menu entry===
    In marble/src/KdeMainWindow.cpp use
     
    http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKRecentFilesAction.html
     
    to create an open recent menu entry for the KDE version of Marble.
    Adding the same functionality to the Qt version of Marble is a bonus task.
     
    Level of difficulty: EASY
     
    === Update the country information to 2010 ===
    Marble is using the CIA World Factbook for displaying country information.
    Have a look at the python script
     
    marble/data/ciasource/cia2kml.py
     
    and use it to compile the latest information from the latest version of the Factbook:
     
    https://www.cia.gov/library/publications/the-world-factbook/
     
    Once done you need to do some extensive testing to see whether the information got properly applied.
     
    Level of difficulty: EASY
     
    === Implement fast adding of measurement points by ctrl+click ===
    See [https://bugs.kde.org/show_bug.cgi?id=232098 Bug 232098] for more information.
     
    Level of difficulty: MEDIUM
     
    === More Intelligent Time Range Selection for the Earthquake Plugin ===
    See [https://bugs.kde.org/show_bug.cgi?id=300184 Bug 300184] for more information.
     
    Level of difficulty: EASY
     
    === Download Progress Bar for Marble Qt ===
    The KDE version of Marble has a nice progress bar in the statusbar that shows the progress of tile downloading. Users of Qt Marble don't see any progress indication. Please change that: Have a look at MarblePart::setupDownloadProgressBar() in marble_part.cpp (part of the implementation in the KDE version) and integrate a similar progress bar feature in QtMainWindow.cpp, the Qt version of Marble. The feature can be tested using View => Redisplay for example, which triggers a re-download of tiles on the screen.

    Latest revision as of 17:45, 25 October 2016

    This page is now on the community wiki.