Skip to content

Latest commit

 

History

History
59 lines (46 loc) · 3.52 KB

CONTRIBUTING.md

File metadata and controls

59 lines (46 loc) · 3.52 KB

Contributing to PySol FC

You want to contribute? That's great! Welcome aboard. First of all see these links for general guidelines for contributing to open source.

Contribution constraints

How you can contribute

  • Translate PySol to a human language you know.
  • Test the "master" branch version of the version control repository or other prereleases.
  • Try to reproduce open issues
  • Try to fix bugs.
  • Add new games.
  • Improve the documentation / online help
  • Refactor the code.
  • Add new features.
  • Contribute graphics
  • Improve the site
  • Package PySol for a new package repository or OS, or update existing packages.
  • Make a monetary donation.
  • Star or Watch the repository on GitHub

Adding new games

First of all there is the "Solitaire Wizard" which may be used to generate many custom variants. It lives in the Edit menu.

Otherwise, the games' sources live under the pysollib/games/ directory in the repository, and are written in Python 2.7/3.x and you can try inheriting from an existing variant class.

Contributing changesets / patches / diffs

One can contribute changesets either by opening pull-requests or merge requests, or by submitting patches generated by git diff or git format-patch to a developer's email (e.g @shlomif's ) or uploading it to a web service (e.g: a pastesite, dropbox, or Google Drive).

The Release Process

In order to publish a new version, follow these steps:

  1. Update NEWS.asciidoc.
  2. Update the VERSION_TUPLE = line in pysollib/settings.py.
  3. Test using gmake test .
  4. git commit the changes .
  5. git tag pysolfc-2.6.5 (or equivalent version).
  6. git push and git push --tags to https://github.com/shlomif/PySolFC .
  7. Wait for the AppVeyor build for the tag to complete and scan the .exe using https://www.virustotal.com/ .
  8. Run gmake dist.
  9. Use rexz9 on dist/PySol*.tar.xz.
  10. Go to https://sourceforge.net/projects/pysolfc/files/PySolFC/ and add a folder called PySolFC-2.6.5 (note the capitalisation).
  11. Add the tar.xz and the .exe there and mark them as defaults for the right OSes.