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.doo...@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/
___________________________________________________________
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/

Reply via email to