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

raise level of entityNameLength to "error" #27

Open
mobb opened this issue Nov 15, 2019 · 8 comments
Open

raise level of entityNameLength to "error" #27

mobb opened this issue Nov 15, 2019 · 8 comments

Comments

@mobb
Copy link
Contributor

mobb commented Nov 15, 2019

de facto, this has been true all along - that if the entityName is longer than a certain length, the package cannot be uploaded into pasta. But the check is classified as a warn, implying that the package can go in. This has happened a few times.

Our original premise was that the only ECC-violations that caused "error" (and denial of upload to pasta) were those that meant the data table itself was unusable. And technically, an entityName that is too long does not fit that. But the pattern we have seen in data packages is the same string in entityName and entityDescription -- which is bad practice.

Comment here on whether you think it's OK to elevate the status of this check to "error"

@atn38
Copy link

atn38 commented Nov 15, 2019 via email

@gastil
Copy link
Collaborator

gastil commented Nov 15, 2019

Good to catch that error with the ECC before it hits pasta and causes pasta grief. I approve. The limit of 256 characters is obviously way bigger than best practice. But our logic of being able to set this an error rather than a warn, at least for the present, allows us to do this with the 256 char limit. In future I suggest we tighten that to perhaps 100 or 150 characters. But that tighter limit would have to go thru the approval cycle and could only be argued to be a warn since it does not prevent data use.

Does the checker explanation to the user mention that entityName should not be identical to entityDescription? We discussed adding a category between info and warn, maybe alert. Would crimes against BP be worthy of alert? ;)

@mobb
Copy link
Contributor Author

mobb commented Nov 15, 2019

alert issue is #23

@mobb
Copy link
Contributor Author

mobb commented Nov 15, 2019

please confirm, @gastil, what you think we should do for entityName, now:
a) set to error and set limit to 256
b) set to error and leave limit at 100 (current limit for a warn)
c) leave as is (a warn, which allows pasta to blow up)

If you want a new check, make a new issue

@gastil
Copy link
Collaborator

gastil commented Nov 15, 2019

I vote (a) now, imediately and (b) in 6 months after the procedural notification of the IMC.

@srearl
Copy link
Collaborator

srearl commented Nov 15, 2019

Elevating this to error seems like a prudent change. This will aid, as suggested, eliminating any confusion about including description details in entityName, and, unusual but possible, including data in that element. I include hashes in my file names so would be quite opposed to a length limit less than 100 characters. I can comment on the other issue but will add here that I very much do NOT like the idea of adding alert as a new level. info, warn, and error make perfect sense and I think adding alert is only going to add complexity and confusion.

@mobb
Copy link
Contributor Author

mobb commented Nov 15, 2019

For future reference, checks adhere to the BP here:
https://ediorg.github.io/data-package-best-practices/EMLmetadata/entity-datatable-spatialraster-spatialvector-storedprocedure-view-otherentity.html

For how to use entityName, objectName and entityDescription, look about half way down the page. This link is a little clunky right now, it will be edited when I get the section headers sorted out (probably next week)

@srearl
Copy link
Collaborator

srearl commented Nov 15, 2019

this is an aside but interesting would be to do (1) an analysis of how ent names currently residing in pasta are treated, and (2) whether data users find that they provide any value beyond the entity description.

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

4 participants