Your tutorial looks great Damion! Thank you for sharing.

I am not sure about the vocabulary you are trying to estabilish though (update vs revision). I understand what you mean but I would just stick with 'If the tool changed behavior you have to bump the version.' No need to specifically name the steps as it can cause confusion (revision has a different meaning in version control world). 

The side fact is, that even if you do not raise the version of the tool while uploading, the Tool Shed will try to detect whether there were any behavior-altering changes. In case there were it will generate new 'installable revision' (not an update to the latest one).

Planemo is a nice tool for tooldev purposes and I am glad you found it.

Other good resources for tooldevs are the IUC and devteam tool repositories: https://github.com/galaxyproject/tools-iuc https://github.com/galaxyproject/tools-devteam that are full of high quality tools. 

Also developing tools openly in a GitHub repo is a recommended way and deeper integration with Tool Shed is a feature to come.

Thank you very much for using Galaxy

Regards

Martin

On Thu, Mar 12, 2015 at 7:27 PM Dooley, Damion <Damion.Dooley@bccdc.ca> wrote:
I've prepared a few slide-decks for an in-house Galaxy tool-development workshop, available at https://github.com/Public-Health-Bioinformatics/galaxy-tool-tutorials in pdf and libre office odp format.  I thought others might appreciate them or have feedback.  I see now the https://planemo.readthedocs.org/en/latest/writing_standalone.html tutorial which will be a good resource for us too!

In the "Galaxy tool Versioning" deck devoted to making people aware of what versioning means for tools, I said:

"An update: a cosmetic change or functional enhancement that doesn't affect the previous output behaviour of the tool.  (This can also include bug fixes that remedy previously useless output.)

A revision: a functional enhancement that changes the current output of the tool, or marks significant enhancements."

So is that agreeable?  I was trying to get at the fact that Galaxy will let you upload code changes without necessarily incrementing the tool's version #, so thinking of the allowable cases for that "update" situation.

Damion

Hsiao lab, BC Public Health Microbiology & Reference Laboratory, BC Centre for Disease Control
655 West 12th Avenue, Vancouver, British Columbia, V5Z 4R4 Canada
___________________________________________________________
Please keep all replies on the list by using "reply all"
in your mail client.  To manage your subscriptions to this
and other Galaxy lists, please use the interface at:
  https://lists.galaxyproject.org/

To search Galaxy mailing lists use the unified search at:
  http://galaxyproject.org/search/mailinglists/