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

Create JSON schemas for things we describe on the web #432

Closed
7 tasks done
acka47 opened this issue Dec 18, 2020 · 6 comments
Closed
7 tasks done

Create JSON schemas for things we describe on the web #432

acka47 opened this issue Dec 18, 2020 · 6 comments
Assignees

Comments

@acka47
Copy link
Contributor

acka47 commented Dec 18, 2020

@acka47
Copy link
Contributor Author

acka47 commented Dec 18, 2020

@TobiasNx If you are interested in this and don't know what to do next week, you might pick this up, add a description of yourself to examples/person/valid/tb.json and start working on a JSON Schema to validate the person profiles in examples/person/valid/.

TobiasNx added a commit that referenced this issue Dec 21, 2020
TobiasNx added a commit that referenced this issue Dec 21, 2020
TobiasNx added a commit that referenced this issue Dec 21, 2020
@TobiasNx
Copy link
Contributor

TobiasNx commented Dec 21, 2020

Suggestions:

  • Instead of colleague i think team would be a good element/knot. Through membership of a team, you could associate colleagues, but as field of its own you need to add new members to every team mate individually as I did with my id to every other member.

  • Consistent usage of lobid-organisations for all organisation refrences e.g. in alumni.

Question:

  • Should the subschemas be more generic? Since not only persons but other parts of our web-publications could be described?

TobiasNx added a commit that referenced this issue Dec 21, 2020
TobiasNx added a commit that referenced this issue Dec 21, 2020
TobiasNx added a commit that referenced this issue Dec 21, 2020
@dr0i
Copy link
Member

dr0i commented Jan 22, 2021

What is the status of this? Can we open a PR of the branch to review?

@acka47
Copy link
Contributor Author

acka47 commented Jan 25, 2021

I haven't found the time yet to work on this. Will do later this week hopefully.

@acka47
Copy link
Contributor Author

acka47 commented Feb 17, 2021

I have added entries for each product and project in the examples folder. (More as a note to self), here are some things we will need to clarify, some earlier, some later:

  • i18n: Adding the name property for persons and projects/products, I used two different approaches: language maps for products/projects as we want to list German and English names and just a key for persons as we do not intent to add a person's name in different languages. However, this would result in two different schemas for the same property. One way towards a common approach would be to use different files per language (and indicating the file's @language in the context) instead of one file per entry with language maps. Then we wouldn't have to use language maps at all. -> Discuss i18n options #473
  • What relations do we need between the different types of resources? Lots of them are straightforward but especially the relations between different projects and products wil need some thought. (In the diagram I used uses, improves & updates but we probably should start with only two broader defined relations. Or we might even makes these relations separate nodes to add more context/descriptions to them. -> Create high-level overview of type relations #444
  • Create and use a project-specific JSON-LD context (for now, I have added "@context": "https://schema.org" for most entries which is enough for development. In the end, we will have to take a deeper look and create a application-specific context.) -> Use custom JSON-LD context #472

@acka47
Copy link
Contributor Author

acka47 commented Dec 16, 2021

I addressed the open questions in other issues and created an additional one so that we can close this issue.

@acka47 acka47 closed this as completed Dec 16, 2021
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

3 participants