Issue Section Options (issue-section)

JSON Schema

{
  "$id": "https://dlvhdr.github.io/gh-dash/configuration/issue-section/schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "description": "Defines a section in the dashboard's Issues view.\n\nhttps://dlvhdr.github.io/gh-dash/configuration/issue-section/",
  "properties": {
    "filters": {
      "description": "Defines the GitHub search filters for the issues in the section's table.\n\nhttps://dlvhdr.github.io/gh-dash/configuration/issue-section/#filters",
      "title": "Issue Filters",
      "type": "string"
    },
    "layout": {
      "$ref": "https://dlvhdr.github.io/gh-dash/configuration/layout/issue/schema.json"
    },
    "limit": {
      "minimum": 1,
      "title": "Issue Fetch Limit",
      "type": "integer"
    },
    "title": {
      "description": "Defines the section's name as displayed in the tabs for the issues view.\n\nhttps://dlvhdr.github.io/gh-dash/configuration/issue-section/#title",
      "title": "Issue Title",
      "type": "string"
    }
  },
  "required": [
    "title",
    "filters"
  ],
  "title": "Issue Section Options",
  "type": "object"
}

Required Properties

• Issue Title
• Issue Filters

Issue Title (title)

This setting defines the section’s name. The dashboard displays this value in the tabs for the issues view.

Issue Filters (filters)

This setting defines the GitHub search filters for the issues in the section’s table.

Don’t specify is:issue for this setting. The dashboard always adds that filter for issue sections.

You can define any combination of search filters. To make it easier to read and maintain your filters, we recommend using the >- syntax after the filter key and writing one filter per line.

For example:

- title: Involved
  filter: >-
    is:open
    involves:@me
    -author:@me    

For more information about writing filters for searching GitHub, see Understanding the search syntax and Searching issues and pull requests in GitHub’s documentation.

Issue Section Layout (layout)

You can define how an issue section displays items in its table by setting options for the available columns. You can define a column’s width, whether it grows to fill available space, and whether the column should be visible at all.

Note that if the length of a column’s text exceeds the defined column width, the view truncates the column’s text to two characters shorter than the column’s width. For example, if the width is 6, gh-dash displays as gh-d.

Column headings have their color defined by the theme.colors.text.primary setting.

For more information, see Issue Section Layout

Issue Fetch Limit (limit)

This setting defines how many issues the dashboard should fetch for the section when:

• The dashboard first loads.
• The fetch interval elapses.
• You navigate to the next issue in a table without another fetched issue to display.
• You use the refresh current section or refresh all sections commands.

This setting overrides the defaults.issuesLimit setting.