search

MouseLand / cellpose-napari

napari plugin for cellpose (see www.cellpose.org) - an anatomical segmentation tool
https://cellpose-napari.readthedocs.org
BSD 3-Clause "New" or "Revised" License
47 stars 22 forks source link

add categories and preview page #18

Closed chili-chiu closed 2 years ago

chili-chiu commented 2 years ago

Hello!

I’m Chi-Li Chiu, application scientist at CZI working on napari and the napari hub.

I’m reaching out with this pull request to ask for your help preparing your plugin for a new “Filter by Category” feature we’ll be launching for the napari hub near the end of January.

This PR does 2 things:

  1. adds our proposed labels to .napari/config.yml to help users find your plugin
  2. adds an Action to your repository in .github/workflows/plugin_preview.yml to help you preview changes to your plugin’s napari hub page

What is the “Filter by Category” feature?

We will let users filter plugins on the napari hub by Category, based on your own annotations of your plugin selected fro terms in the EDAM Bioimaging ontology. You are able to specify, in your .napari/config.yml file, any number of EDAM labels at whatever depth of the taxonomy is most appropriate. You can see a mockup of this feature below

prototype of filter dialog letting napari hub users filter plugins based on workflow step

We currently support viewing category metadata on the individual plugin pages, but before we let users filter by category, we want to get categories populated for as many plugins as possible.

For more information, see A plugin developer’s guide to categories on the napari hub.

Can you make adding category labels to my plugin easier?

Totally. We know that learning about the EDAM Bioimaging ontology and adding relevant categories is a lot of work. So we took a first pass for you!

To help you get started, our team has reviewed your plugin’s description and metadata and identified category labels that we feel would be a good fit based on the information you’ve provided so far. These were proposed initially by our Biocuration Team who are experts in annotating scholarly literature with biological concepts, then reviewed by me. We did our best to select relevant labels, but we might be wrong! Please review and edit these categories to best fit your plugin… and let us know how we did! We’re exploring ways that we might be able to automate suggestions in the future for new plugin developers. We’ll be launching the “Filter by Category” feature on Jan 27, 2022, so if you’d like to take advantage of this new feature, please merge this PR by then!

Can you let me preview the changes before I merge this PR?

Yeah, we can do that… not just for categories, but for all of your metadata!

To make it easier for you to update and maintain your plugin’s metadata, and see immediately how changes to links or your description will affect your napari hub listing, we’ve launched a new service that lets you preview your plugin’s page directly from PRs onto your plugin repository (like this one) and see what metadata you might be missing.

Prototype of the napari hub Preview Page feature, which highlights missing metadata from your Github repository

This service has two parts:

To use the new Preview Page feature, you simply need to install the Github App by clicking here and configuring it for this repository. Once you do that, make any update to this PR and you will get a comment from the @napari-hub-bot below with a link to your preview page!

For more information, see Setting Up Plugin Page Previews

We hope that these new features are useful to you! Happy to answer any questions here or on our Discussions page.

chili-chiu commented 2 years ago

Just want to follow up on this PR- we’re planning to launch the filter-by category feature on Jan 27. If you want your plugin to be filterable by category when we launch, please review and merge this PR by then. Many plugins have already added categories, for example: https://www.napari-hub.org/plugins/napari-segment-blobs-and-things-with-membranes

If you don’t want categories, feel free to close this PR.