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

health warnings on index pages #172

Closed
holfordm opened this issue Aug 1, 2018 · 11 comments · Fixed by #173
Closed

health warnings on index pages #172

holfordm opened this issue Aug 1, 2018 · 11 comments · Fixed by #173
Assignees
Labels

Comments

@holfordm
Copy link
Collaborator

holfordm commented Aug 1, 2018

Due to the nature of the catalogue, which contains a lot of summary records with incomplete descriptions, there is a case for providing warnings on the index pages for persons, works and places.
They might appear after any external links and might say something like "the following references reflect [the current coverage of the catalogue] and are unlikely to be comprehensive". The part in square brackets could link elsewhere (e.g. a more developed version of this page, https://github.com/bodleian/medieval-mss/wiki/The-catalogue-records:-sources,-coverage-and-scope)

  • is this a good idea?
  • would it be easy to implement technically?
@andrew-morrison
Copy link
Contributor

Inserting such messages in the middle of the list of fields would be technically difficult. More likely to be possible is a paragraph at the bottom, after all the links. Possibly in a form of a footnote as in this mockup:
mockup_of_footnote_on_person_page

@ahankinson
Copy link
Contributor

What is the scope of the 'comprehensitivity' that we are warning our users we are not covering?

@ahankinson
Copy link
Contributor

I should rephrase: What level of comprehensiveness would our users expect? Is it better to provide this notice on person/place/work, or to have a note on the MS record that indicates the level at which the MS is described?

It just seems like we're being a bit oblique with our language here -- What is meant is 'Not all of our records are fully described, and as such this is not a comprehensive list of all occurrences of this person in our collection.'

It seems to me that that sort of general note can be made at a higher level (under 'About', possibly) than on every individual person/work/place record?

@andrew-morrison
Copy link
Contributor

@holfordm can answer this better, but there are some examples in recent comments added to #79

@holfordm
Copy link
Collaborator Author

holfordm commented Aug 1, 2018

The about page does, I think, already cover this question quite well, but my worry is that no-one reads the about page, and there may be an expectation from users that the page for Cicero's Orationes in C. Verrem for example (http://medieval-qa.bodleian.ox.ac.uk/catalog/work_1259) contains all known copies of that text in the Bodleian, which it doesn't, because some are hidden in the record for Cicero, Works (http://medieval-qa.bodleian.ox.ac.uk/catalog/work_1276)
On the one hand we don't want the records to look overly fussy, on the other hand we don't want to mislead users.

@holfordm
Copy link
Collaborator Author

holfordm commented Aug 3, 2018

Martin Kauffmann agrees about the need for warnings. The form of words should be "The above references reflect only [the current coverage of the online catalogue] and may not be comprehensive.".

The link should be to the About page in the first instance.

@andrew-morrison
Copy link
Contributor

Just to confirm, these should be on work, person and place pages? Not manuscripts or search results.

@ahankinson
Copy link
Contributor

OK.

Should we do this same warning for the other TEI Catalogues?

@holfordm
Copy link
Collaborator Author

holfordm commented Aug 6, 2018 via email

@andrew-morrison
Copy link
Contributor

The HTML has been implemented.

@IgnatG: Please add some CSS to make p elements with a class of "coveragewarning" appear in the same size font and colour as the labels on pages such as this:

http://medieval-qa.bodleian.ox.ac.uk/catalog/person_40183277

@IgnatG
Copy link

IgnatG commented Aug 9, 2018

this is done now

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

Successfully merging a pull request may close this issue.

4 participants