Miniature/Development: Difference between revisions

From Maemo Wiki
Jump to navigationJump to search
imported>qgil
imported>sixwheeledbeast
No edit summary
 
(51 intermediate revisions by 7 users not shown)
Line 1: Line 1:
[[Category:Miniature|Development]]
{{Miniature}}
== The concept ==
[[Miniature]] is a chess board that is always with you, ready to let you play and learn wherever you go.


* The main use case is playing online against other players at http://www.freechess.org/ (FICS)
Most content of this page has moved to http://miniature-chess.org/
* Now imagine that you can also chat with the other player.
We are waiting to get the BugzillaReports extension running to move the rest.
* Play P2P games against other players next to you or remotely with your Contacts.
* Learning is important: watch games live, review stored games and also process offline the lessons offered at FICS.
* And not only regular chess. Think also on Suicide, Crazyhouse...
 
Miniature is a Qt application with a C/C++ backend and a QML UI. The architecture is modular, thinking on the addition of different servers and types of interaction.
 
We are targeting our development on MeeGo Harmattan and the Nokia N9 but we welcome maintainers for other ports e.g. MeeGo upstream, Symbian, Android-Necessitas, Qt powered desktops...


== Project status ==
== Project status ==


* 2011-08-15: New Miniature UX concepts integrated to the master branch - the new engine gets a UI ([http://wiki.maemo.org/images/2/25/2011-08-12_16-25-47.png screenshot]).
Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.
* 2011-08-13: Miniature can be developed using Qt Creator ([https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk instructions]).
* 2011-08-01: [https://garage.maemo.org/pipermail/chess-developer/2011-August/000159.html Miniature 0.2.1 released!] The new Encore engine and the new QML UI, together for the first time. The game can do real seeks but still no real games.
* 2011-07-27: New UI targetting MeeGo Harmattan developed in parallel - [https://gitorious.org/testdef source] & [https://bugs.maemo.org/show_bug.cgi?id=12315 packages] for Nokia N9/N950.
* 2011-07-18: engine refactored around [https://garage.maemo.org/pipermail/chess-developer/2011-July/000153.html Encore], a GNUChess wrapper. This is the beginning of a rewrite.
* 2011-07-06: request to port to [[Meego]] : http://forum.meego.com/showthread.php?p=25031
 
The Miniature project was born as a proposal sent to the Maemo community on 2009-10-31. Check the [[Miniature/archive|archive]] if you want to dig in the past.
 
== Get started ==
 
Currently you can build Miniature with the latest Qt SDK (including the Harmattan target) or the Harmattan Platform SDK. The Miniature sources and commit logs are available at https://gitorious.org/miniature/ . Both SDKs come with an emulator for deploying your app. All the better if you have a Nokia N950 or N9 to test on device.
 
* [https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk Instructions to build Miniature with Qt Creator]
 
== Development channels ==
* The developer discussion happens in the project [https://garage.maemo.org/pipermail/chess-developer/ mailing list].
* We also follow the more user-oriented Talk discussion thread: [http://talk.maemo.org/showthread.php?t=33764 Contributors needed: the killer free chess game for Maemo].
* With some luck you will find us online at #miniature in irc.freenode.net.
* Code repository at http://gitorious.org/miniature
* No bugzilla at this point.
 
 
 
== Architecture ==
See the [[Miniature/Development/Architecture|Miniature architecture]] wiki page. (outdated)


== Strings & localization ==
=== Miniature 0.5 release ===
We don't have stable strings implemented and therefore the localization task hasn't started yet. See [[Miniature/Development/Strings]].


== Get involved ==
Tasks COMMITTED for Miniature 0.5.
New contributors are welcome! You can help testing and bugfixing new releases focusing on the current phase or you can pick one item more distant in the roadmap and go ahead with it. No matter what you do we recommend you to stay on focus.


See the [[Miniature/Development/Instructions|instructions]] to setup your Miniature development environment. Also, do not forget to install the more [[Miniature/Development/Qt4_for_Maemo5|hildonized Qt4 for Maemo5 package from extras-devel]]!
{{#bugzilla:id=7867,12345,12351,12359,12390,12394,12419,12420,12426,12435,12455,12456,12464
  |columns=id,severity,status,resolution,summary
  |sort=resolution,status,severity,id
}}


There are some [[/Policies | policies]] that we follow in the project.
=== Backlog ===


=== Send us patches! ===
{{#bugzilla:
Found a bug? Spotted code smell? We glady accept patches! There are three ways to send patches to us:
  |columns=id,severity,priority,assignee,status,resolution,summary
* By [https://bugs.maemo.org/buglist.cgi?product=Miniature reporting the bug], and hopefully attaching a patch that solves the stated problem (but just reporting bugs is also appreciated).
  |product=Miniature
* By using the [https://garage.maemo.org/mailman/listinfo/chess-developer chess-devel mailing list]: A ML-friendly patch can be created with "git format-patch HEAD~n", where n specifices how many commits (starting from HEAD) should be converted to patches;
  |priority=Medium,Low,Unspecified
* By issuing a merge request: Send us a link to your public git repo (including branch/revision), or use the merge request feature from http://gitorious.org.
  |status=unconfirmed,new,assigned,needinfo,reopened
  |sort=status,id
}}


== References ==
=== Easyfix (suited for newcomers) ===
* [http://www.craftychess.com/ Crafty] is a free, open-source computer chess program.
* [http://www.v7f.eu/public/n800/chess/ EBoard and Crafty] for the N810/N800/N770 - [http://maemo.org/downloads/product/OS2007/chess OS2007 Downloads page].
* [http://knights.sourceforge.net/ Knights] aimed to be the ultimate chess resource for the K Desktop Environment... years ago.
* [http://pacaq.sourceforge.net/ pacaq] is a chess game visualizing and analysis tool done with the Maemo 4.1 Qt4 port - [http://talk.maemo.org/showthread.php?t=21793 Talk thread].
** From all programs on this list, this is the only one were reading the code is worth your time.
* [http://scid.sourceforge.net/ SCID], a chess database application for Windows, Linux and Mac OS operating systems.
** See also [http://scid.sourceforge.net/scidpocket.html SCID Pocket]
* [http://www.gnu.org/software/xboard/ Xboard] is a graphical user interface for chess in all its major forms.
* [http://www.freechess.org/ freechess.org] Website of the Free Intrnet Chess Server (FICS)
** [http://www.freechess.org/Help/AllFiles.html commands reference]


== Contributors ==
{{#bugzilla:
* [http://maemo.org/profile/view/mikhas Michael Hasselmann]: lead developer.
  |columns=id,severity,priority,assignee,status,resolution,summary
* [http://maemo.org/profile/view/kore Dennis Stötzel]: chess logics.
  |product=Miniature
* [http://maemo.org/profile/view/hasselmm Mathias Hasselmann]: veteran programmer.
  |keywords=easyfix
* [http://gitorious.org/~Malcolm Dariusz Mikulski]: P2P telepathy integration.
  |status=unconfirmed,new,assigned,reopened
* [http://maemo.org/profile/view/qgil Quim Gil]: documentation.
  |sort=priority,severity,priority,status,id
* [http://maemo.org/profile/view/kittykat Ekaterina Gerasimova]: Game icon.
}}


Special thanks to [http://en.wikipedia.org/wiki/User:Cburnett Colin M.L. Burnett] for his free piece set used by Wikipedia.
Looking for more? There is more at the [http://miniature-chess.org/wiki/Wishlist Wishlist].

Latest revision as of 17:57, 15 May 2023

Miniature - Play chess everywhere you go!
.: Home : Releases : Wish list : Development : Coding style :.
Most content of this page has moved to http://miniature-chess.org/
We are waiting to get the BugzillaReports extension running to move the rest.

Project status

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

Miniature 0.5 release

Tasks COMMITTED for Miniature 0.5.

{{#bugzilla:id=7867,12345,12351,12359,12390,12394,12419,12420,12426,12435,12455,12456,12464

 |columns=id,severity,status,resolution,summary
 |sort=resolution,status,severity,id

}}

Backlog

{{#bugzilla:

 |columns=id,severity,priority,assignee,status,resolution,summary
 |product=Miniature
 |priority=Medium,Low,Unspecified
 |status=unconfirmed,new,assigned,needinfo,reopened
 |sort=status,id

}}

Easyfix (suited for newcomers)

{{#bugzilla:

 |columns=id,severity,priority,assignee,status,resolution,summary
 |product=Miniature
 |keywords=easyfix
 |status=unconfirmed,new,assigned,reopened
 |sort=priority,severity,priority,status,id

}}

Looking for more? There is more at the Wishlist.