Skip to content

[KNOW-175]: Remove catalog-info.yaml files where gemspecs are auto-ingested into Developer Portal - #67

Merged
aman-singh merged 1 commit into
masterfrom
devProdUseGemspecCatalogIngestor
Jul 17, 2026
Merged

[KNOW-175]: Remove catalog-info.yaml files where gemspecs are auto-ingested into Developer Portal#67
aman-singh merged 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'

🤖 Generated with Claude Code

@modethirteen
modethirteen force-pushed the devProdUseGemspecCatalogIngestor branch from 7d02960 to 90f8d3a 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): declarative_authorization.gemspec
@modethirteen
modethirteen force-pushed the devProdUseGemspecCatalogIngestor branch from 90f8d3a to d4d5e61 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

@modethirteen modethirteen changed the title [KNOW-175]: migrate catalog-info.yaml metadata into gemspec for Developer Portal ingestion [KNOW-175]: Remove catalog-info.yaml files where gemspecs are auto-ingested into Developer Portal Jul 16, 2026
@modethirteen
modethirteen marked this pull request as ready for review July 16, 2026 23:25
@modethirteen
modethirteen requested a review from a team as a code owner July 16, 2026 23:25
@aman-singh
aman-singh merged commit 531dd18 into master Jul 17, 2026
8 checks passed
@aman-singh
aman-singh deleted the devProdUseGemspecCatalogIngestor branch July 17, 2026 00:19
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.

2 participants