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:	6a121e9
Status:	✅  Deploy successful!
Preview URL:	https://cb9bd4ce.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.