Skip to content

[KNOW-175]: migrate catalog-info.yaml metadata into gemspec for Developer Portal ingestion#241

Draft
modethirteen wants to merge 1 commit into
masterfrom
devProdUseGemspecCatalogIngestor
Draft

[KNOW-175]: migrate catalog-info.yaml metadata into gemspec for Developer Portal ingestion#241
modethirteen wants to merge 1 commit into
masterfrom
devProdUseGemspecCatalogIngestor

Conversation

@modethirteen

@modethirteen modethirteen commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

Summary

The Developer Portal now automatically discovers your gem's .gemspec and lists it in the catalog — you no longer need a hand-written catalog-info.yaml. This PR removes the authored catalog-info.yaml for this gem and moves the still-relevant details into the .gemspec, so the portal keeps the catalog entry up to date from the gem itself.

What changed

  • Removed catalog-info.yaml
  • refined summary and description

Why the gem summary and description changed

The removed catalog-info.yaml had a description that was more detailed than the gemspec's summary, so we included both in the gemspec: a short summary and the fuller description.

Optional gemspec metadata the Developer Portal understands

The portal reads the basics (name, description, version, docs link) straight from the gem. If you want to fine‑tune how your gem shows up, you can add any of these optional keys to the metadata hash in your .gemspec. Everything below is opt‑in; leave a key out and the portal just makes a sensible default guess.

Metadata key What it controls
developer.appf.io/owner The team that owns the gem. If omitted, the portal uses the gem's code owners.
developer.appf.io/system The larger product or system this gem is part of.
developer.appf.io/component The app or service this gem lives inside / belongs to.
developer.appf.io/depends_on Other apps, services, or resources this gem relies on (comma‑separated).
developer.appf.io/consumes_apis APIs this gem calls (comma‑separated).
developer.appf.io/lifecycle Set to deprecated to flag the gem as deprecated.
documentation_uri Standard gem metadata key — point it at your gem's docs and the portal links to them.

Example:

spec.metadata['developer.appf.io/owner'] = 'my-team'
spec.metadata['developer.appf.io/system'] = 'my-product'

This is a draft — no action needed from you yet. Feel free to tweak the gemspec metadata above before it merges.

🤖 Generated with Claude Code

@modethirteen modethirteen force-pushed the devProdUseGemspecCatalogIngestor branch from f51911b to 27868d5 Compare July 14, 2026 06:23
…talog ingestor

Remove authored catalog-info.yaml and express the mappable metadata via the
gemspec's documentation_uri and developer.appf.io/* keys so the Developer Portal
gemspec catalog ingestor generates the component.

Gems (1): ae_page_objects.gemspec
@modethirteen modethirteen force-pushed the devProdUseGemspecCatalogIngestor branch from 27868d5 to 1c867a6 Compare July 14, 2026 06:41
@modethirteen modethirteen changed the title chore: migrate catalog-info.yaml metadata into gemspec for Developer Portal ingestion [KNOW-175]: migrate catalog-info.yaml metadata into gemspec for Developer Portal ingestion Jul 14, 2026
@kermitapp

kermitapp Bot commented Jul 14, 2026

Copy link
Copy Markdown

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

Successfully merging this pull request may close these issues.

1 participant