From 43b93577b50336294892cf1f164e6847798efb22 Mon Sep 17 00:00:00 2001 From: "@s.roertgen" Date: Wed, 24 Jan 2024 11:41:37 +0100 Subject: [PATCH 1/7] Add first faq draft #263 --- FAQ.md | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 FAQ.md diff --git a/FAQ.md b/FAQ.md new file mode 100644 index 0000000..2085e12 --- /dev/null +++ b/FAQ.md @@ -0,0 +1,85 @@ +# FAQ + +Hier sammeln und beantworten wir häufig gestellte Fragen und geben Best-Practice Beispiele. + +## Wie gebe ich ein Projekt als Entstehungszusammenhang einer Ressource an? (in Abgrenzung zu Förderinformationen) (siehe + +OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und soweit ich weiß auch in Niedersachsen – wurde angedacht, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. + +Nehmen wir als Beispiel [OER-Content.NRW](https://www.dh.nrw/kooperationen/OER-Content.nrw-42), wo Materialien durch Konsortien aus mindestens drei Organisationen erstellt werden. Das Projekt "Einführung in die Betriebswirtschaftslehre" (mit der beispielhaften URI `https://example.org/bwl-oer`) wird etwa von einem Konsortium aus sieben Organisationen durchgeführt. + +Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Material in den Metadaten irgendwo einem Projekt zuordnen. Dafür würde sich etwa [`sdo:producer`](https://schema.org/producer) anbieten ([`sdo:Project`](https://schema.org/Project) ist derzeit als ein Untertyp von `Organization` in pending eingetragen, so dass es hier auch mit dem für `producer` erwarteten Typ `Organization` passen würde): + +```json +{ + "@context": "http://schema.org", + "id": "https://example.org/bwl-oer", + "producer": [ + { + "id": "http://example.org/bwl-projekt", + "type": "Project", + "name": "Einführung in die Betriebswirtschaftslehre" + } + ] +} +``` + +## Wie gebe ich Förderinformationen als Entstehungskontext einer Ressource an? (in Abgrenzung zu Projekt) + +Angaben zu einer Förderung können über das Feld [`funder`](https://dini-ag-kim.github.io/amb/latest/#funder) hinterlegt werden. + +```json +{ + "@context": [ + "https://w3id.org/kim/lrmi-profile/draft/context.jsonld", + { + "@language": "de" + } + ], + "id": "https://example.org/course", + "name": "Beispielkurs", + "type": [ + "LearningResource", + "Course" + ], + "funder": { + "type": "FundingScheme", + "id": "https://example.org/foerderprogramm", + "name": "Förderprogramm A" + } +} +``` + + +## Wie gebe ich Serienzugehörigkeit an? + +Die Serienzugehörigkeit kann über das Feld `isPartOf` abgebildet werden. + +```json +{ + "id":"https://dabi.fwu.de/edu-sharing/components/render/bc26e99d-755b-4970-a22d-67fbc875a734", + "name":"Deutsche Revolution 1848/49", + "type":[ + "LearningResource", + "VideoObject" + ], + "learningResourceType":[ + { + "id":"https://w3id.org/kim/hcrt/video", + "prefLabel":{ + "de":"Video", + "en":"Video" + } + } + ], + "isPartOf":{ + "type":"CreativeWorkSeries", + "name":"Geschichte interaktiv" + } +} +``` + +## Wie erfasse ich die Metadatenersteller:in? + + + From 745ff1e7fddc70622194f336692256d1c96780e6 Mon Sep 17 00:00:00 2001 From: "@s.roertgen" Date: Thu, 25 Jan 2024 13:20:36 +0100 Subject: [PATCH 2/7] Add info to describe metadata creator #263 --- FAQ.md | 43 ++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 40 insertions(+), 3 deletions(-) diff --git a/FAQ.md b/FAQ.md index 2085e12..a760c76 100644 --- a/FAQ.md +++ b/FAQ.md @@ -4,10 +4,8 @@ Hier sammeln und beantworten wir häufig gestellte Fragen und geben Best-Practic ## Wie gebe ich ein Projekt als Entstehungszusammenhang einer Ressource an? (in Abgrenzung zu Förderinformationen) (siehe -OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und soweit ich weiß auch in Niedersachsen – wurde angedacht, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. - +OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und soweit ich weiß auch in Niedersachsen – wurde angedacht, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. Nehmen wir als Beispiel [OER-Content.NRW](https://www.dh.nrw/kooperationen/OER-Content.nrw-42), wo Materialien durch Konsortien aus mindestens drei Organisationen erstellt werden. Das Projekt "Einführung in die Betriebswirtschaftslehre" (mit der beispielhaften URI `https://example.org/bwl-oer`) wird etwa von einem Konsortium aus sieben Organisationen durchgeführt. - Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Material in den Metadaten irgendwo einem Projekt zuordnen. Dafür würde sich etwa [`sdo:producer`](https://schema.org/producer) anbieten ([`sdo:Project`](https://schema.org/Project) ist derzeit als ein Untertyp von `Organization` in pending eingetragen, so dass es hier auch mit dem für `producer` erwarteten Typ `Organization` passen würde): ```json @@ -81,5 +79,44 @@ Die Serienzugehörigkeit kann über das Feld `isPartOf` abgebildet werden. ## Wie erfasse ich die Metadatenersteller:in? +Informationen über die Metadaten einer Ressource können im Feld [`mainEntityOfPage`](https://dini-ag-kim.github.io/amb/latest/#mainentityofpage) angegeben werden. +Dort kann ein Attribut `creator` hinterlegt werden, in dem die Metadatenersteller:innen erfasst werden (s. auch [`creator`](https://dini-ag-kim.github.io/amb/latest/#creator) Attribut im AMB). +```json +{ + "id":"https://dabi.fwu.de/edu-sharing/components/render/bc26e99d-755b-4970-a22d-67fbc875a734", + "name":"Deutsche Revolution 1848/49", + "type":[ + "LearningResource", + "VideoObject" + ], + "learningResourceType":[ + { + "id":"https://w3id.org/kim/hcrt/video", + "prefLabel":{ + "de":"Video", + "en":"Video" + } + } + ], + "mainEntityOfPage": [ + { + "id": "https://awesome-metadata.org" + "creator": [ + { + "name": "Maria Müller", + "type": "Person" + } + ] + } + ], + "isPartOf":{ + "type":"CreativeWorkSeries", + "name":"Geschichte interaktiv" + } +} + + + +``` From 1b3a1f217a16c9ffd648fa80d7c3af7a6d15a162 Mon Sep 17 00:00:00 2001 From: "@s.roertgen" Date: Thu, 25 Jan 2024 13:23:40 +0100 Subject: [PATCH 3/7] Add hint about FAQ in README #263 --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index d5b56ad..f072173 100644 --- a/README.md +++ b/README.md @@ -31,6 +31,10 @@ Publiziert Siehe auch die [StöberSpecs-Prozesse](https://github.com/dini-ag-kim/oer-stoeberspecs). +## Frequently Asked Questions + +In unserem [FAQ](./FAQ.md) beantworten wir häufig gestellte Fragen. + ### Beteiligte Personen - Adrian Pohl (hbz & KIM), [@acka47](https://github.com/acka47) From dacdce4c5cc8e43335c85c7d615fd611c6ae485d Mon Sep 17 00:00:00 2001 From: "@s.roertgen" Date: Thu, 25 Jan 2024 14:46:34 +0100 Subject: [PATCH 4/7] =?UTF-8?q?Remove=20copy=20paste=20fragments...?= =?UTF-8?q?=F0=9F=A7=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/FAQ.md b/FAQ.md index a760c76..e2be848 100644 --- a/FAQ.md +++ b/FAQ.md @@ -2,7 +2,7 @@ Hier sammeln und beantworten wir häufig gestellte Fragen und geben Best-Practice Beispiele. -## Wie gebe ich ein Projekt als Entstehungszusammenhang einer Ressource an? (in Abgrenzung zu Förderinformationen) (siehe +## Wie gebe ich ein Projekt als Entstehungszusammenhang einer Ressource an? (in Abgrenzung zu Förderinformationen) OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und soweit ich weiß auch in Niedersachsen – wurde angedacht, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. Nehmen wir als Beispiel [OER-Content.NRW](https://www.dh.nrw/kooperationen/OER-Content.nrw-42), wo Materialien durch Konsortien aus mindestens drei Organisationen erstellt werden. Das Projekt "Einführung in die Betriebswirtschaftslehre" (mit der beispielhaften URI `https://example.org/bwl-oer`) wird etwa von einem Konsortium aus sieben Organisationen durchgeführt. From ed290912d3f8f3440c46cb6b785ae5cde4187b05 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Manuel=20Kummerl=C3=A4nder?= Date: Mon, 12 Feb 2024 09:02:32 +0100 Subject: [PATCH 5/7] Formulierungen neutraler gemacht --- FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/FAQ.md b/FAQ.md index e2be848..67e78d9 100644 --- a/FAQ.md +++ b/FAQ.md @@ -4,7 +4,7 @@ Hier sammeln und beantworten wir häufig gestellte Fragen und geben Best-Practic ## Wie gebe ich ein Projekt als Entstehungszusammenhang einer Ressource an? (in Abgrenzung zu Förderinformationen) -OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und soweit ich weiß auch in Niedersachsen – wurde angedacht, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. +OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und nach aktuellem Kenntnisstand auch in Niedersachsen – wurde erwogen, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. Nehmen wir als Beispiel [OER-Content.NRW](https://www.dh.nrw/kooperationen/OER-Content.nrw-42), wo Materialien durch Konsortien aus mindestens drei Organisationen erstellt werden. Das Projekt "Einführung in die Betriebswirtschaftslehre" (mit der beispielhaften URI `https://example.org/bwl-oer`) wird etwa von einem Konsortium aus sieben Organisationen durchgeführt. Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Material in den Metadaten irgendwo einem Projekt zuordnen. Dafür würde sich etwa [`sdo:producer`](https://schema.org/producer) anbieten ([`sdo:Project`](https://schema.org/Project) ist derzeit als ein Untertyp von `Organization` in pending eingetragen, so dass es hier auch mit dem für `producer` erwarteten Typ `Organization` passen würde): From dc9e2f470bc7b8f6fea6b2e86a25ce34fb7f4e74 Mon Sep 17 00:00:00 2001 From: Adrian Pohl Date: Tue, 13 Feb 2024 10:47:31 +0100 Subject: [PATCH 6/7] =?UTF-8?q?Aktualisiere=20Angaben=20zu=20`sdo:Project`?= =?UTF-8?q?,=20erg=C3=A4nze=20Links?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ...zu verwandten Tickets. (#263) --- FAQ.md | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/FAQ.md b/FAQ.md index 67e78d9..6f8932a 100644 --- a/FAQ.md +++ b/FAQ.md @@ -6,7 +6,7 @@ Hier sammeln und beantworten wir häufig gestellte Fragen und geben Best-Practic OER entstehen häufig im Rahmen von Projekten, an denen mehrere Institutionen beteiligt sein können. In NRW – und nach aktuellem Kenntnisstand auch in Niedersachsen – wurde erwogen, diese Projekte zu erfassen, ihnen also eigene Identifier und strukturierte Beschreibungen zu geben. Eine Anforderung wäre dann, in einem Projekt entstandene OER mit dem Projekt zu verlinken, um schließlich Materialien – etwa in OERSI – nach Projekt filtern zu können. Nehmen wir als Beispiel [OER-Content.NRW](https://www.dh.nrw/kooperationen/OER-Content.nrw-42), wo Materialien durch Konsortien aus mindestens drei Organisationen erstellt werden. Das Projekt "Einführung in die Betriebswirtschaftslehre" (mit der beispielhaften URI `https://example.org/bwl-oer`) wird etwa von einem Konsortium aus sieben Organisationen durchgeführt. -Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Material in den Metadaten irgendwo einem Projekt zuordnen. Dafür würde sich etwa [`sdo:producer`](https://schema.org/producer) anbieten ([`sdo:Project`](https://schema.org/Project) ist derzeit als ein Untertyp von `Organization` in pending eingetragen, so dass es hier auch mit dem für `producer` erwarteten Typ `Organization` passen würde): +Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Material in den Metadaten irgendwo einem Projekt zuordnen. Dafür würde sich etwa [`sdo:producer`](https://schema.org/producer) anbieten ([`sdo:Project`](https://schema.org/Project) ist ein Untertyp von `Organization`, so dass es hier auch mit dem für `producer` erwarteten Typ `Organization` passen würde): ```json { @@ -22,6 +22,8 @@ Materialien sollen nach Herkunftsprojekt gefiltert werden, d.h. ich muss das Mat } ``` +Verwandtes Ticket: [#17](https://github.com/dini-ag-kim/amb/issues/17) + ## Wie gebe ich Förderinformationen als Entstehungskontext einer Ressource an? (in Abgrenzung zu Projekt) Angaben zu einer Förderung können über das Feld [`funder`](https://dini-ag-kim.github.io/amb/latest/#funder) hinterlegt werden. @@ -48,11 +50,15 @@ Angaben zu einer Förderung können über das Feld [`funder`](https://dini-ag-ki } ``` +Verwandtes Ticket: [#102](https://github.com/dini-ag-kim/amb/issues/102) + ## Wie gebe ich Serienzugehörigkeit an? Die Serienzugehörigkeit kann über das Feld `isPartOf` abgebildet werden. +Beispiel: + ```json { "id":"https://dabi.fwu.de/edu-sharing/components/render/bc26e99d-755b-4970-a22d-67fbc875a734", @@ -77,6 +83,8 @@ Die Serienzugehörigkeit kann über das Feld `isPartOf` abgebildet werden. } ``` +Verwandte Tickets: [#174](https://github.com/dini-ag-kim/amb/issues/174), [#175](https://github.com/dini-ag-kim/amb/issues/175)) + ## Wie erfasse ich die Metadatenersteller:in? Informationen über die Metadaten einer Ressource können im Feld [`mainEntityOfPage`](https://dini-ag-kim.github.io/amb/latest/#mainentityofpage) angegeben werden. @@ -115,8 +123,5 @@ Dort kann ein Attribut `creator` hinterlegt werden, in dem die Metadatenerstelle "name":"Geschichte interaktiv" } } - - - ``` From 76ff7bb193fd63d5604142822609e2858698867d Mon Sep 17 00:00:00 2001 From: Adrian Pohl Date: Mon, 19 Feb 2024 15:39:40 +0100 Subject: [PATCH 7/7] Add q&a re. `affiliation` & `datePublished` (#263) --- FAQ.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/FAQ.md b/FAQ.md index 6f8932a..ad3dcc1 100644 --- a/FAQ.md +++ b/FAQ.md @@ -125,3 +125,10 @@ Dort kann ein Attribut `creator` hinterlegt werden, in dem die Metadatenerstelle } ``` +## Können Organisationen auch Affiliations zu anderen Organisationen haben? + +Nein, das ist gemäß er Property https://schema.org/affiliation, die wir im AMB nachnutzen, nicht vorgesehen. + +## Wie ist das Veröffentlichungsdatum (inhaltlich) gemeint? Das Datum der ersten Veröffentlichung des Werks? Das Datum der letzten (aktuellsten) Veröffentlichung/Überarbeitung? + +Laut der Beschreibung der Property https://schema.org/datePublished, die wir im AMB nachnutzen, handelt es sich um das Datum der ersten Veröffentlichung. Für Überarbeitungen eignet sich [`dateModified`](https://w3id.org/kim/amb/latest/#datemodified). \ No newline at end of file