Move references to issues and versions supporting XDG to separate keys

[EmilyGraceSeville7cf]

I propose a change which allows:

• listing all versions with XDG support outside files.{{file}}.help
• linking related issues outside files.{{file}}.help

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "definitions": {
    "empty": {
      "type": "string",
      "pattern": "^\\s+$"
    },
    "version": {
      "type": "string",
      "not": {
        "anyOf": [
          {
            "$ref": "#/definitions/empty"
          },
          {
            "pattern": "\\.\\."
          }
        ]
      },
      "examples": ["1.2.3"]
    }
  },
  "title": "specification",
  "description": "A specification of files or folders in the $HOME folder for a program\nhttps://github.com/b3nj5m1n/xdg-ninja",
  "type": "object",
  "required": ["name", "files"],
  "properties": {
    "name": {
      "title": "name",
      "description": "A program name\nRestrictions:\n- can't contain just spaces\nhttps://github.com/b3nj5m1n/xdg-ninja",
      "type": "string",
      "minLength": 1,
      "not": {
        "$ref": "#/definitions/empty"
      },
      "examples": ["abook"]
    },
    "files": {
      "title": "files",
      "description": "Files and folders for a program\nhttps://github.com/b3nj5m1n/xdg-ninja",
      "type": "array",
      "uniqueItems": true,
      "minItems": 1,
      "items": {
        "description": "A file or a folder for a program\nhttps://github.com/b3nj5m1n/xdg-ninja",
        "type": "object",
        "required": ["path", "movable", "help"],
        "properties": {
          "path": {
            "title": "path",
            "description": "A path to a file or a folder\nRestrictions:\n- can't contain just spaces\nhttps://github.com/b3nj5m1n/xdg-ninja",
            "type": "string",
            "minLength": 1,
            "not": {
              "$ref": "#/definitions/empty"
            },
            "examples": ["$HOME/.abook"]
          },
          "movable": {
            "title": "movable",
            "description": "Whether a file or a folder is movable to a place other than $HOME\nhttps://github.com/b3nj5m1n/xdg-ninja",
            "type": "boolean"
          },
          "help": {
            "title": "help",
            "description": "A help message for a user in markdown\nRestrictions:\n- can't contain just spaces\nhttps://github.com/b3nj5m1n/xdg-ninja",
            "type": "string",
            "minLength": 1,
            "not": {
              "$ref": "#/definitions/empty"
            },
            "examples": [
              "Alias abook to use custom locations for configuration and data:\n\n```bash\nalias abook=abook --config \"$XDG_CONFIG_HOME\"/abook/abookrc --datafile \"$XDG_DATA_HOME\"/abook/addressbook\n```\n"
            ]
          },
          "supported": {
            "title": "supported",
            "description": "Versions XDG specification is supported\nRestrictions:\n- can't contain just spaces\n- can't contain two or more consecutive dots\nhttps://github.com/b3nj5m1n/xdg-ninja",
            "oneOf": [
              {
                "$ref": "#/definitions/version"
              },
              {
                "type": "array",
                "minItems": 1,
                "uniqueItems": true,
                "items": {
                  "type": "object",
                  "properties": {
                    "from": {
                      "description": "A version XDG specification is supported since\nRestrictions:\n- can't contain just spaces\n- can't contain two or more consecutive dots\nhttps://github.com/b3nj5m1n/xdg-ninja",
                      "$ref": "#/definitions/version"
                    },
                    "to": {
                      "description": "A version XDG specification is supported till\nRestrictions:\n- can't contain just spaces\n- can't contain two or more consecutive dots\nhttps://github.com/b3nj5m1n/xdg-ninja",
                      "$ref": "#/definitions/version"
                    }
                  },
                  "minProperties": 1,
                  "additionalProperties": false
                }
              }
            ]
          },
          "issues": {
            "title": "issues",
            "description": "Linked issues to explain such things like plans on adding XDG specification support, reason for dropping it\nRestrictions:\n- can't contain just spaces\nhttps://github.com/b3nj5m1n/xdg-ninja",
            "type": "array",
            "minItems": 1,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "pattern": "^https://",
              "not": {
                "$ref": "#/definitions/empty"
              },
              "examples": ["https://github.com/nektos/act/issues/1678"]
            }
          }
        }
      }
    }
  }
}

Examples

act.json can be rewritten as:

{
  "name": "act",
  "files": [
    {
      "path": "$HOME/.actrc",
      "movable": true,
      "help": "Act supports the XDG spec.\n\n```sh\nmkdir \"$XDG_CONFIG_HOME/act\"\nmv .actrc \"$XDG_CONFIG_HOME/act/actrc\"\n```\n",
      "issues": ["https://github.com/nektos/act/issues/1678"]
    }
  ]
}

Note how issue reference has been moved from files.{{file}}.help to files.{{file}}.issues.

aegisub.json can be rewritten as:

{
    "files": [
        {
            "help": "Some help text",
            "movable": false,
            "path": "$HOME/.aegisub",
            "issues": ["https://github.com/Aegisub/Aegisub/issues/226"]
        }
    ],
    "name": "Aegisub"
}

Note that is there is no files.{{file}}.supported which means no versions support XDG specification.