Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Develop streamlined process for applying FIT tool quality checks #50

Open
k-doering-NOAA opened this issue Nov 16, 2023 · 7 comments
Open
Labels
assigned to FIT committee coworking session Sustainable Admin Addresses FIT vision of sustainable administration

Comments

@k-doering-NOAA
Copy link
Member

k-doering-NOAA commented Nov 16, 2023

Related to #34 , #35.

Tool quality scheme draft

@k-doering-NOAA k-doering-NOAA converted this from a draft issue Nov 16, 2023
@k-doering-NOAA k-doering-NOAA added the Sustainable Admin Addresses FIT vision of sustainable administration label Nov 16, 2023
@k-doering-NOAA k-doering-NOAA moved this from Todo to In Progress in FY24 Strategic Plan Nov 22, 2023
@k-doering-NOAA
Copy link
Member Author

Discussed at the November FIT meeting. We plan to meet in Dec for a coworking session on applying the checklist

@k-doering-NOAA
Copy link
Member Author

k-doering-NOAA commented Dec 6, 2023

Coworking session yesterday was super helpful! We tried applying the docs and test portion of the checklist to the SSMSE tool. Some things we learned:

  • It would be helpful for users to specify where things are on the checklist to expedite the review process; otherwise, the reviewer may miss it.
  • Some elements of the checklist should be included directly on the FIT's tool page (in particular, adding basic usage directly on the page)
  • Longer descriptions of metadata so the user understands for example who is an "author" would be helpful
  • Some of the elements of the checklist needed rewording for clarity

Next steps:

  • Put together a github issue form and make the checklist in markdown. This will allow us to simulate an actual onboarding process
  • Schedule another coworking meeting where we can apply the checklist to a different tool, using the new github issue process.

@k-doering-NOAA
Copy link
Member Author

k-doering-NOAA commented Jan 5, 2024

Started a repo and began putting together a github issue form and checklist in markdown for our next coworking meeting.

  • Check that checklist meets comments made from last coworking session
  • Add metadata needed to answer the checklist to the google issue form
  • Go through the form with a real tool. Can copy over to multiple issues for each person to try their own checklist.

@k-doering-NOAA
Copy link
Member Author

Some takeaways from our January coworking session are listed here: https://docs.google.com/document/d/12CVGWsHG4vBYvwzmViyomfzN9CWcrCuuKH94m1364Dk/edit#heading=h.tythoymrdy8k

@k-doering-NOAA
Copy link
Member Author

We had another coworking session today (notes).

Some takeaways:

  • May need a badge for tools we will never assess and let people know why it won't be assessed.
  • For tools where we are in progress of assessing, putting an "assessment in progress" badge (with a link) may help let people know we are working on the tool quality standards
  • We need a process for engaging developers as we start applying tool quality standards to the tools in the toolbox
  • may need a different checklist for webapps; our current one did not fit well.

@k-doering-NOAA
Copy link
Member Author

Working on converting the google docs documentation to blog posts on the resources blog. @amandalbradford and @rklasky have volunteered to review the content before we merge it into main (thank you!).

@k-doering-NOAA
Copy link
Member Author

see #35 (comment)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
assigned to FIT committee coworking session Sustainable Admin Addresses FIT vision of sustainable administration
Projects
Status: In Progress
Development

No branches or pull requests

1 participant