meeting-1on1-action

This GitHub Action creates a new issue for a 1:1 meeting with your manager.

Usage

# .github/workflows/schedule.yml
on:
  schedule:
    # every Monday at 01:00 UTC
    - cron: '0 1 * * 1'

jobs:
  schedule:
    runs-on: ubuntu-latest

    permissions:
      contents: read
      issues: write

    steps:
      - uses: actions/[email protected]

      - uses: stoe/[email protected]
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

This reads from a .github/101.yml configuration file within your repository.

Configuration file

To use the meeting-1on1-action you have to provide a configuration file within your repository.

Manager's github.com username without the @.

manager: my_manager

Report's github.com username without the @.

report: me

Label is created if not already available.

label: '1:1 meeting'

Issue title. If not provided will default to @my_manager/@me 1:1 Topics 10/22/2020. Set this to title: false to use the default.

title: '@{% manager %}/@{% report %} 1:1 Topics {% date %}'

Issue template string or path to an issue template in .github/ISSUE_TEMPLATE/

template: |
  ### Last 1:1

  {% last %}

  ### Topics for today's meeting

  - [ ] ...

template: .github/ISSUE_TEMPLATE/101.md

title and template variables

These will be replaced in your configuration title and template / within your .github/ISSUE_TEMPLATE/ file.

• {% date %}: auto filled with the date of the 1:1 meeting

• {% last %}: auto filled with reference link(s) to the last 1:1 meeting issue(s)

• {% manager %}: auto filled with the manager's github.com username provided in the config file

• {% report %}: auto filled with the reports' github.com username provided in the config file

Inputs

The GITHUB_TOKEN secret. More info available here.

repo-token: ${{ secrets.GITHUB_TOKEN }}

The path for the issue configurations within your repository. Defaults to .github/101.yml.

configuration-path: .github/101.yml

When is the meeting? Acceptable values:

• today
• tomorrow
• x days from now (where x is the number of days away the meeting is)

Defaults to today and will fall back to today if none of the above are provided.

scheduled-day: today

Outputs

If you need the Issue URL of the created 1:1 meeting issue for another step, you can use the url output.

For example:

steps:
  - uses: actions/[email protected]

  - uses: stoe/[email protected]
    id: issue
    with:
      repo-token: ${{ secrets.GITHUB_TOKEN }}

  - run: echo "${{ steps.issue.outputs.url }}"

License

MIT © Stefan Stölzle