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
jberkus added a new comment to an issue you are following: `` Link to discussion about this proposal: https://lists.fedoraproject.org/archives/list/cloud@lists.fedoraproject.org/... ``
To reply, visit the link below or just reply to this email https://pagure.io/atomic-wg/issue/243
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
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
The issue: `Require DESCRIPTION label for FLIBS containers` of project: `atomic-wg` has been assigned to `jberkus` by jberkus.
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
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
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
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
The issue: `Require DESCRIPTION label for FLIBS containers` of project: `atomic-wg` has been assigned to `jasonbrooks` by jberkus.
-
James Hogarth -
Josh Berkus