Skip to content

People

Contributor spotlight cards. Each spotlight entry is resolved against generated.contributors.authors[] for display name and avatar.

People slide showing contributor spotlight cards with avatars and summaries

Example

Slide (in presentation.yaml)

yaml
- template: people
  enabled: true
  title: Contributor spotlight
  subtitle: Contributors who shaped this cycle
  content:
    banner_prefix: Thanks to
    contributors_link_label: contributors
    banner_suffix: who drove this release forward.
    github_fa_icon: fa-github
    quote_fa_icon: fa-quote-left
    banner_fa_icon: fa-heart
    spotlight:
      - login: ava-product
        fa_icon: fa-user-astronaut
        summary: |-
          Defined the starter-kit structure and led the checklist overhaul.

          - Unblocked first-run setup
          - Simplified release review
      - login: mo-rendering
        summary: Improved export polish and PDF spacing.
      - login: ren-docs
        summary: Reworked migration notes for faster team adoption.
      - name: Launch Coordinator
        summary: Kept the readiness review moving across product, docs, and support.
      - summary: Coordinated the launch checklist without needing a public handle.

Matching data (in generated.yaml)

yaml
generated:
  contributors:
    total: 5
    authors:
      - login: ava-product
        name: Ava Product
        avatar_url: https://avatars.githubusercontent.com/u/1?v=4
        merged_prs: 7
        first_time: false
      - login: mo-rendering
        name: Mo Rendering
        avatar_url: https://avatars.githubusercontent.com/u/2?v=4
        merged_prs: 4
        first_time: false

Data sources

RegionSource
CardsOne per spotlight[]. Name from spotlight[].name, matching authors[].name, or login when present
AvatarIcon badge from spotlight[].fa_icon or the default icon sequence
Summaryspotlight[].summary, with lightweight rich text support
GitHub linkhttps://github.com/{login}, only when login is present
Bannerbanner_prefix + linked {total} {contributors_link_label} + banner_suffix
Banner linksite.links.repository.url/graphs/contributors

Fields

FieldRequiredType
titleyesstring
subtitlestring
content.banner_prefixstring
content.contributors_link_labelstring
content.banner_suffixstring
content.github_fa_iconstring
content.quote_fa_iconstring
content.banner_fa_iconstring
content.spotlightyesarray

content.spotlight[]

FieldRequiredType
loginstring
namestring
summaryyesstring; supports lightweight rich text
fa_iconstring

If a login has no match in generated.contributors.authors[], the card renders using the login as the display name. If only name is set, the card does not render a GitHub handle link. If both login and name are omitted, the card renders as a summary-only card. summary accepts the lightweight rich text documented in Concepts.

Icon defaults are fa-user-astronaut, fa-user-ninja, and fa-user-secret for profile cards, fa-github for handles, fa-quote-left for quote decoration, and fa-heart for the banner. Additional profile cards default to fa-user-secret. Icon fields use supported values from the Font Awesome icon reference.