update homepage example

[BigBlueHat]

• Describe the JSON-LD homepage in the main example.

Fixes #880 by avoiding the problem altogether.

[cloudflare-workers-and-pages]

Deploying json-ld-org with    Cloudflare Pages

Latest commit:	6bc3e3a
Status:	✅  Deploy successful!
Preview URL:	https://5e684e1f.json-ld-org.pages.dev
Branch Preview URL:	https://update-homepage-example.json-ld-org.pages.dev

View logs

[mscuthbert]

It does fix the problem from #889 - but I don't know if this is the best direction for the project. With the Lennon example I knew exactly something I could do with json-ld -- "ah, it's a way of representing metadata and linked data about people...and probably other things...in JSON! Cool"

When I see a site that describes its own website...I wouldn't think that this is the proper library for ''my'' purposes -- it brings out a lot the meta in metadata.

Why not describe an animal instead? Common-name, species, etc. Egg-laying:boolean? As an added bonus it immediately becomes a symbol of the project! (asked ChatGPT for common animals not already closely associated with particular tech projects and Otter, Swan, and Barn Owl came up ... along with more specific things like Tanuki (Racoon dog -- my fav), Agouti,Opah ("bonus: natural circle-logo shape"), etc.

[BigBlueHat]

@mscuthbert I take your point, for sure. The animal idea is fun. 🐱 However, we'd need a different context (or we could define one, as we'd done for Person back in the day)--schema.org doesn't have an Animal class (yet...).

What if we went back to your example in #889, but added both spouses? I can drop the "A Simple Example" header (which is redundant anyhow) which should buy us a bit more space.

I'll work that up on this PR (as the foundational file has changed considerable since you made #889...sorry about that 😉), and then you (and hopefully others!) can let me know what you/y'all think.

[mscuthbert]

What if we...added both spouses?

Sure! It makes it a great example of how JSON and thus JSON-LD can represent not just simple key-values but also ordered arrays/lists of values -- a win, win!

And as soon as I made the animal suggestion I was like: no...what grabbed me about JSON-LD was that I instantly saw that it was a key to implementing Dublin-Core or other human-creator w/ creation linked-metadata in a supported fashion, and an animal taxonomy example makes it look more like Wikidata-in-JSON!

[davidlehn]

• That "now" thing isn't needed in the update.
• Does this make things better or worse? Someone unfamiliar with intricacies of JSON-LD might ask if those spouse values are concurrent or ordered, and if ordered, why are they reversed. All this can be explained, and may open a discussion about data modeling, but I'd think the main front page example should avoid any of that.
• I'll again suggest we use something without complexities. If birthPlace was added to that context, it would be simple enough.

[BigBlueHat]

That "now" thing isn't needed in the update.

Sorry, yeah. That's a left over from the WebPage example. I'll clean it out.

Does this make things better or worse? Someone unfamiliar with intricacies of JSON-LD might ask if those spouse values are concurrent or ordered, and if ordered, why are they reversed. All this can be explained, and may open a discussion about data modeling, but I'd think the main front page example should avoid any of that.

Great questions! I think it makes things better by piquing interest. That said, some additional content on the site (or the resurrection of the Primer and certainly more examples) may be in order, but I see the generation of more questions/curiosities as a great thing. 😁

I'll again suggest we use something without complexities. If birthPlace was added to that context, it would be simple enough.

"Complexities" being the multiple spouses? Given the value just expressed of "piquing interest" (especially given @mscuthbert's feedback), I rather like the way this opens up curiosities.

@mscuthbert fwiw, JSON-LD does not treat arrays as "ordered" (vs. JSON) because underneath this shakes out to discrete statements of...

<http://dbpedia.org/resource/John_Lennon> <http://schema.org/birthDate> "1940-10-09"^^<http://www.w3.org/2001/XMLSchema#date> .
<http://dbpedia.org/resource/John_Lennon> <http://schema.org/spouse> <http://dbpedia.org/resource/Cynthia_Lennon> .
<http://dbpedia.org/resource/John_Lennon> <http://schema.org/spouse> <http://dbpedia.org/resource/Yoko_Ono> .
<http://dbpedia.org/resource/John_Lennon> <http://xmlns.com/foaf/0.1/name> "John Lennon" .

...which doesn't include any implicit ordering. JSON-LD does (of course) allow someone to layer that back in, but this example wouldn't do that, but other pages/info could.

You can read more about that in https://www.w3.org/TR/json-ld11/#sets-and-lists

At any rate, I'm in favor of this wee bit of "complexity" to help promote inquiry.

[davidlehn]

Looks like this needs a retarget to main? Has a lot of extra changes now.

[BigBlueHat]

Looks like this needs a retarget to main? Has a lot of extra changes now.

This should be fixed now. You should only see one commit.

[BigBlueHat]

Looks like this now...