welcome: please sign in

Upload page content

You can upload content for the page named below. If you change the page name, you can also upload content for another page. If the page name is empty, we derive the page name from the file name.

File to load page content from
Page name
Comment
Last name of the author of the GNU Manifesto

Page Locked

HelpOnPatchCreation

HelpContents > HelpForDevelopers > HelpOnPatchCreation

You found a way to fix a bug, and you like moin developer to include your fix, but you don't know how to create a patch. Here is how:

1. How to make a new patch

  1. Get the latest version of the source and make your edits. MoinDev/MercurialGuide tells you more.

  2. Before you continue ask yourself the following questions:
    • Is the patch useful to most users? A feature useful for you isn't necessarily useful for everybody.

    • Is it the WikiWay? Doing something the WikiWay is more likely to get included than doing it in any other way.

    • Is this a good patch? Clean, easy to read and understand code is more likely to be included.

    • Have you tested the code well enough? Some of the MoinCoreTeamGroup members like tests for any code, and will not be happy to include new code without tests.

  3. Also consider this:

    • Create extensions if possible!

    • Smaller, cleanly separated patches are much more likely to get included than bigger, mixed ones.

    • Well documented code. To save time, write clear code that is self-explaining. :-)

    • User documentation - if you add a feature, add user documentation.
    • Easy to maintain code - either you or some other developer will have to maintain the code. It should be easy, as we don't have time for this.

2. Patches for current production version

These are only included if: