pkg-request.yml

name: Package Request
description: Request the addition of a package
labels: ["request"]
body:
  - type: markdown
    attributes:
      value: >
        #### Don't request an update of a package,
        [We have a script for that](https://alpha.de.repo.voidlinux.org/void-updates/void-updates.txt).
        However, a quality pull request may help.
  - id: name
    type: input
    attributes:
      label: Package name
      placeholder: foobar9k
    validations:
      required: true
  - id: homepage
    type: input
    attributes:
      label: Package homepage
      placeholder: https://foobar9k.org
    validations:
      required: true
  - id: description
    type: textarea
    attributes:
      label: Description
      description: What does the package do?
      placeholder: >
        Foobar9k is a music player that turns your music up to 11.
        It provides features X, Y, and Z, which other music players in Void don't.
    validations:
      required: true
  - type: markdown
    attributes:
      value: >
        ## Quality Requirements

        To be included in the Void repository, software must meet **at least one** of the following requirements.
        Exceptions to the list are possible, and might be accepted, but are extremely unlikely.
        If you believe you have an exception, make an argument for why that particular piece of software,
        while not meeting any of the following requirements, is a good candidate for inclusion in void-packages.


        In particular, new themes are highly unlikely to be accepted.
        Simple shell scripts are unlikely to be accepted unless they provide considerable value to a broad user base.
        New fonts may be accepted if they provide value beyond aesthetics
        (e.g. they contain glyphs for a script missing in already packaged fonts).


        Browser forks, including those based on Chromium and Firefox, are generally not accepted.
        Such forks require heavy patching, maintenance and hours of build time.
  - id: quality
    type: dropdown
    attributes:
      label: Does the requested package meet the quality requirements?
      description: |
        **System:** The software should be installed system-wide, not per-user
        **Compiled:** The software needs to be compiled before being used, even if it is software that is not needed by the whole system
        **Required:** Another package either within the repository or pending inclusion requires the package
      multiple: true
      options:
        - System
        - Compiled
        - Required
    validations:
      required: true
  - type: markdown
    attributes:
      value: >
        ## Release Status

        Software need to be used in version announced by authors as ready to use by the general public - usually called releases.
        Betas, pre-releases, and arbitrary VCS revisions won't be accepted.
  - id: released
    type: dropdown
    attributes:
      label: Is the requested package released?
      description: "The software is available in a version announced by authors as ready-to-use by the general public"
      options:
        - "Yes"
        - "No"
    validations:
      required: true