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

CMSIS Packs - nomenclature is inconsistent and a little confusing #566

Open
TommyMurphyTM1234 opened this issue May 23, 2023 · 6 comments
Open

Comments

@TommyMurphyTM1234
Copy link

TommyMurphyTM1234 commented May 23, 2023

Originally reported here:

To summarise:

  1. Should "CMSIS Packs" rather than also "CMSIS packs" etc. be used consistently?
  2. The CMSIS Packs view initially says "(no packages) - Press the Refresh button to register all available packages" but the relevant button in the view toolbar (left arrow above right arrow) is called Update the CMSIS packs definitions according to the tooltip.
  3. The use of terms "refresh", "register" and "update" are a bit confusing. I think that the Update the CMSIS packs definitions toolbar button causes the master index (or indices if there are multiple CMSIS Packs repositories configured?) to be downloaded so that thereafter the CMSIS Packs view has a local list of CMSIS Packs and where to find them etc.? CMSIS Packs are not themselves downloaded unless/until the user explicitly clicks on them and selects Install? That being the case the nomenclature should probably more accurately describe/reflect the operations that take place and should be consistent.
ilg-ul added a commit that referenced this issue May 23, 2023
@ilg-ul
Copy link
Contributor

ilg-ul commented May 23, 2023

  1. Should "CMSIS Packs" rather than also "CMSIS packs" etc. be used consistently?

This first one was easy, fixed.

@ilg-ul
Copy link
Contributor

ilg-ul commented May 23, 2023

For 2 & 3, could you suggest how to update the messages?

@TommyMurphyTM1234
Copy link
Author

For 2 & 3, could you suggest how to update the messages?

The problem I have is that I don't fully understand what's happening in this context to address the nomenclature issues. My assumptions are outlined above but I don't know if they're correct. These details need to be ascertained in other to use the appropriate nomenclature, verbs, nouns etc.

@ilg-ul
Copy link
Contributor

ilg-ul commented May 26, 2023

When you have time to suggest better messages, I'll update them and proceed with a new release.

@ilg-ul
Copy link
Contributor

ilg-ul commented Jun 27, 2023

@TommyMurphyTM1234, a new release is planned in a few days, probably the end of the week, so, if you have suggestion on how to improve the messages, now would be a good moment to contribute them.

@ilg-ul
Copy link
Contributor

ilg-ul commented Jul 24, 2023

@TommyMurphyTM1234, if there are no further suggestions, can you close this issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants