Skip to content

Latest commit

 

History

History
43 lines (34 loc) · 1.57 KB

CONTRIBUTING.md

File metadata and controls

43 lines (34 loc) · 1.57 KB

Contributing

If you like Moonside and want to make it better, help out. It could be as simple as sending Don a nice note on Google+, you could report a bug, or pitch in with some development work.

Bug Reports and Enhancement Requests

Be as specific as possible. Which version are you using? What did you do? What did you expect to happen? Are you planning to submit your own fix in a pull request?

New Domino Puzzles

Do you have an idea for another type of puzzle to include in Moonside? Create an issue, and describe how it would work.

Development

Moonside's software to generate puzzles is written in Python. It also depends on the NetworkX library and the Distributed Evolutionary Algorithms in Python library (DEAP), so those need to be installed via pip or your package manager.

Building a Release

No releases yet, but steps will be something like this:

Before publishing a release, check the following:

  • The unit tests pass.
  • All the instructions are up to date in the README and CONTRIBUTING files.
  • The version number has been incremented.

To publish a release:

  • Run the script to generate the PDF version.
  • Copy it to the gh-pages branch.
  • Commit the gh-pages branch and check that the new version works on the web site.
  • Go to the GitHub releases page, create a new release using a tag like v0.x.0-alpha.
  • Close the milestone.