[atomic-wg] Issue #243 `Require DESCRIPTION label for FLIBS containers`

[Josh Berkus]

jberkus reported a new issue against the project: `atomic-wg` that you are following:
``
We should require a "description" label in FLIBS containers.  This would contain
a long, narrative description of the container and how it's supposed to be used,
intended for human readability.   This would include, for all containers:

* what service/software the container provides

It would also include all of the following which are applicable to the container:

* what purpose it fulfills in a larger infrastructure
* what each VOLUME in the container is for and what kinds of storage they need
* any details about dependencies on other container images
* links to documentation or software project pages
* any special requirements the container has (like lots of RAM, or sound server access)
* details on any required configuration, or links to documentation on configuration
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
Link to discussion about this proposal:
https://lists.fedoraproject.org/archives/list/[e-mail].o...
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[James Hogarth]

jhogarth added a new comment to an issue you are following:
``
Suggested text for guidelines added here:

https://fedoraproject.org/wiki/Talk:Container:Guidelines
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
Update from VFAD:

The HELP label will link to a verbose description of how to use the container. For
containers needing substantial instructions, the maintainer will check a file into
dist-git called "help1.txt", "README" or "README.md". Fedora
will ensure that this file has a public link. The maintainer will also have a copy of that
file in the root directory of the container. For such images, the maintainer may choose to
populate the HELP label with a URL pointing to the dist-git file, but is encouraged to
have a one-sentence description before the URL. 

Container Guidelines to be updated soon.
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

The issue: `Require DESCRIPTION label for FLIBS containers` of project: `atomic-wg` has
been assigned to `jberkus` by jberkus.

https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
@jhogarth ok, I merged your text with mine in Container:Guidelines.  Please take a look.

Also, what we discussed during the meeting was requiring the help file (which could have
any of three names) in the root of the image filesystem.  No?
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
This issue now depends on the outcome of #256 
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
New rules found in issue #256:

New requirements:

    Every image is required to have a "description" label, which will be 1-3
lines of human-readable text on what the image is for. This description is meant to be
searchable by skopeo.

    Images are required to have either a "help" label or a "help"
file, the latter being preferred. They should not have both.

    The Help file can be named "help.1" or "README.md". It must be
COPYd into the image and reside in the root directory.

    If the maintainer prefers a "help" label, the label should include an
executable command which displays a help page in some reasonable text format. Minimally,
this could be as simple as "echo 'How to use this image'".

    For users who don't use the Atomic CLI, we will offer simple instructions on how
to display the help ("docker run --rm some:image /bin/cat help1.txt &&
/bin/cat README.md").

    We will do nothing with URLs for the time being. Instead, we will implement a HELPURL
system at some later date when we have the resources to do so completely automatically. In
the meantime, help files are browseable on dist-git.

Does this work for everyone? In this case, the only required change to "atomic
help" is supporting README.md. The reason we want that, btw, is for Github user
friendliness.
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

jberkus added a new comment to an issue you are following:
``
Updated in Wiki.

@jasonbrooks now yours for notifying the maintainers.
``

To reply, visit the link below or just reply to this email
https://pagure.io/atomic-wg/issue/243

[Josh Berkus]

The issue: `Require DESCRIPTION label for FLIBS containers` of project: `atomic-wg` has
been assigned to `jasonbrooks` by jberkus.

https://pagure.io/atomic-wg/issue/243