earthcube / earthcube/communityCollections

Improve AI disclosure beyond Schema.org comment field

Open
#12 2 comments 0 reactions 1 assignee Claimed by @ywkim312 View on GitHub
Dominant language
Python
Stars
1
Forks
1
Avg merge
4h 29m
Merged PRs (30d)
1

Description

## Summary

JSON-LD files under `data/objects/summoned` currently disclose AI-generated metadata with a Schema.org `comment` (for example in earthface files):

"comment": "This dataset metadata was generated with the use of AI and reviewed by an expert. If you see any mistakes please file an issue on GitHub at https://github.com/earthcube/communityCollections/issues."

This works as a short-term disclosure, but Schema.org does not yet have a clear, dedicated way to declare that generative AI was used. See:

- https://github.com/schemaorg/schemaorg/issues/3391

We also need a structured signal that search and display UIs can detect reliably, so AI-assisted records can show an icon, keyword tag, or banner when queried and rendered.

## Direction

1. Keep the human-readable `comment` field as our current AI disclosure text.
2. Track Schema.org issue [#3391](https://github.com/schemaorg/schemaorg/issues/3391) until Schema.org defines recommended markup for generative AI use.
3. Adopt a machine-readable AI-disclosure field (Schema.org-recommended when available; interim structured field if needed) so consumers can detect AI-assisted metadata and show an icon, keyword tag, or banner in query results and detail views.
4. Apply that pattern across JSON-LD under `data/objects/summoned`.
5. Update `scripts/generate_jsonld.py` so newly generated files include both the human-readable disclosure and the machine-readable signal.

## Scope

- Files under `data/objects/summoned`
- Generator logic in `scripts/generate_jsonld.py`
- Downstream display of AI disclosure (icon / keyword tag / banner)

## Acceptance criteria

- [ ] Keep `comment` as the human-readable disclosure
- [ ] Add or adopt a machine-readable AI disclosure signal usable by UIs
- [ ] Track Schema.org #3391 and migrate to the recommended markup when available
- [ ] Apply the pattern to JSON-LD under `data/objects/summoned`
- [ ] Update the generator so new files match
- [ ] Confirm queried/displayed results can show an AI icon, keyword tag, or banner from that signal

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.