Tutorial tools - link in known resources?

[jennaj]

The goal would be to include it whenever a tool that we have this info for would automatically get that linked in, wherever it shows up, without requiring manual curation/updates per tutorial. I would help with this once we get it modeled & others think it would be helpful. These links get sent as part of support all the time - be easier to have a reference built-in for self-help and quick "all-in-one-place" help.

Could involve a reference list of tools linked to known resources. Then when the tutorial web page is generated, if a tool is a match, an icon appears next to the tool [?] or similar, hover over text could state something generic like "Resources", clicked on could go to some auto-generated page with formatting that is human-friendly. Or better, a pop-up with some set of "description > text or link" with a scientific focus, with a "More..." link that goes out to the full page if the user wants all the info.

Seems like we could parse ToolShed info (use common keys) and use that to create the baseline data? Curate out anything that isn't current. Used the generalized repositories "name" below to avoid versions -- think those would require too much maintenance. The tool "id" is one way to link if tools in tutorials also had a the same id tag (seems better than a fuzzy "matching text" type of link... maybe).

Example, could be modeled better, so using just to help clarify:

(repo) name: macs2
(repo) owner: iuc
(repo) synopsis: MACS - Model-based Analysis of ChIP-Seq
(repo) mts: https://toolshed.g2.bx.psu.edu/view/iuc/macs2
(tool) id: macs2_bdgbroadcall
(tool) id: macs2_predictd
(tool) id: .... more, eg. all present in MTS
dev-external: https://github.com/taoliu/MACS
dev-galaxy: https://github.com/galaxyproject/tools-iuc/tree/master/tools/macs2
-- everything 1st section is in the MTS
tutorial-micro: link in common usage solutions/FAQs here
tutorial-micro: .... more of the same
tutorial-full: link in all GTN tutorials that include this tool
tutorial-full: .... more of the same
-- everything 2nd section could be parsed from tuto repos fuzzy search or "name/id" tags
forum-galaxy: https://biostar.usegalaxy.org/local/search/page/?q=macs2
search-hub: https://galaxyproject.org/search/?q=macs2
search-issue: https://github.com/search?q=org%3Agalaxyproject+macs2&type=Issues
-- everything 3rd section is a search, autogenerated from "name"
forum-external: https://groups.google.com/forum/#!forum/macs-announcement
-- 4th section == what would be curated by a person, just once to start with, later whenever new resources are created/discovered. We already include links like that on many tool forms but not all. I don't think there is a starndard format used in tool form help around this BUT if there is (or could be in the future...), we could parse that out.

This resource could have many reuse cases, including in the Galaxy GUI itself. DOI's and other existing tool metadata could be included that would be of interest to scientists (pubs, etc). Not sure about tutorial data libraries/public sample data -- could argue for or against that.

Thoughts?

idea credit: discussion with @shiltemann lead to this

[jennaj]

Interesting addition for tools, maybe can leverage in tutorials? galaxyproject/tools-iuc#1897

Still being discussed: https://gitter.im/galaxy-iuc/iuc?at=5b0ec839ba1a351a68d78dba