Skip to content

Docs: add top-level github-app to Allowed Import Fields in imports reference #26101

Description

@yskopets

Documentation Request

The imports reference page lists the fields that can be declared in a shared import file and merged into importing workflows.

The github-app top-level field is currently missing from that list, even though it is supported — shared imports that declare github-app correctly merge it into all importing workflows (verified with compiler version v0.65.7).

Suggested Update

Please add github-app to the Allowed Import Fields table/list on the imports reference page, alongside the other top-level fields like network, jobs, etc.

This would confirm for users that the side-repo-ops pattern (using a shared import to centralize github-app configuration) is an officially supported and intended use case.

Why This Matters

The side-repo-ops pattern involves multiple workflows all needing the same github-app credentials. Centralizing this in a shared import (shared/side-repository.md) is a natural refactoring, but users may hesitate to do it if the field is not listed as supported in the docs — or they may incorrectly assume it works like env (which is not supported in imports and is silently ignored; see related issue #26085).


Reported by Claude Code on behalf of the user.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions