Refactor the way information (especially links) are presented

[tianon]

This should make it much faster to find the right place to file issues, get help, find out whether upstream maintains an image, etc.

I've done my best to represent each REPO/maintainer.md file appropriately, but I might have missed some (or there might be something else a maintainer prefers be listed there, either more or less descriptive, for example), which would be welcome contributions following this change. ❤️ 👍

Here's an example of what this looks like via GitHub, followed by a screenshot of the Hub's rendering of the same block (for simple comparison):

Quick reference

• Where to get help:
  the Docker Community Forums, the Docker Community Slack, or Stack Overflow

• Where to file issues:
  https://github.com/docker-library/golang/issues

• Maintained by:
  the Docker Community

• Published image artifact details:
  repo-info repo's repos/golang/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/golang
  official-images repo's library/golang file (history)

• Source of this description:
  docs repo's golang/ directory (history)

• Supported Docker versions:
  the latest release (down to 1.6 on a best-effort basis)

[tianon]

@Djelibeybi I think the oraclelinux changes here were some of the largest (slash most different from the rest of the images), so if you wouldn't mind taking a brief look and making sure I've represented the desired info properly, that'd be appreciated! For reference, here's the generated version of oraclelinux/README.md:

Supported tags and respective Dockerfile links

• 7-slim (OracleLinux/7-slim/Dockerfile)
• latest, 7, 7.3 (OracleLinux/7.3/Dockerfile)
• 7.2 (OracleLinux/7.2/Dockerfile)
• 7.1 (OracleLinux/7.1/Dockerfile)
• 7.0 (OracleLinux/7.0/Dockerfile)
• 6-slim (OracleLinux/6-slim/Dockerfile)
• 6, 6.9 (OracleLinux/6.9/Dockerfile)
• 6.8 (OracleLinux/6.8/Dockerfile)
• 6.7 (OracleLinux/6.7/Dockerfile)
• 6.6 (OracleLinux/6.6/Dockerfile)
• 5, 5.11 (OracleLinux/5.11/Dockerfile)

Quick reference

• Where to get help:
  see the "Customer Support" and "Community Support" sections below

• Where to file issues:
  https://github.com/oracle/docker-images/issues

• Maintained by:
  the Oracle Linux Product Team

• Published image artifact details:
  repo-info repo's repos/oraclelinux/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/oraclelinux
  official-images repo's library/oraclelinux file (history)

• Source of this description:
  docs repo's oraclelinux/ directory (history)

• Supported Docker versions:
  the latest release (down to 1.6 on a best-effort basis)

Oracle Linux

Oracle Linux is an open-source operating system available under the GNU General Public License (GPLv2). Suitable for general purpose or Oracle workloads, it benefits from rigorous testing of more than 128,000 hours per day with real- world workloads and includes unique innovations such as Ksplice for zero- downtime kernel patching, DTrace for real-time diagnostics, the powerful Btrfs file system, and more.

How to use these images

The Oracle Linux images are intended for use in the FROM field of an application's Dockerfile. For example, to use Oracle Linux 6 as the base of an image, specify FROM oraclelinux:6.

Official Resources

• Learn more about Oracle Linux
• Unbreakable Linux Network
• Oracle Linux Yum Server

Social media resources

• Twitter
• Facebook
• YouTube
• Blog

Customer Support

Oracle provides support to Oracle Linux subscription customers via the My Oracle Support portal. The Oracle Linux Docker images are covered by Oracle Linux Basic and Premier support subscriptions. Customers should follow existing support procedures to obtain support for Oracle Linux running in a Docker container.

This image is officially supported for Oracle Linux customers with an active Oracle Linux Basic or Premier support subscription on both Oracle Linux 6 and Oracle Linux 7 running the Unbreakable Enterprise Kernel Release 4 and Docker Engine version 1.9 installed from the Oracle Linux Yum Server.

Oracle Linux users without an active support subscription can use either the Oracle distributed version of Docker Engine or the upstream version distributed by Docker. Support is limited to the community-based options outlined below.

Oracle Linux 7

Please review the additional Linux programs supported under Oracle Linux support chapter for more information on the scope of support for Docker.

Please review Chapter 29 of the Oracle Linux 7 Administrator's Guide for details on how to install or upgrade the Unbreakable Enterprise Kernel and Docker Engine packages.

Oracle Linux 6

Please review the additional Linux programs supported under Oracle Linux support chapter for more information on the scope of support for Docker.

Please review Chapter 10 of the Oracle Linux 6 Administrator's Solutions Guide for details on how to install or upgrade the Unbreakable Enterprise Kernel and Docker Engine packages.

Community Support

For Oracle Linux users without a paid support subscription, the following resources are available:

• The Oracle Linux Forum on the Oracle Technology Network Community.
• The ##oraclelinux IRC channel on Freenode.

License

View the Oracle Linux End-User License Agreement for the software contained in this image.

[tianon]

Oh shoot, oraclelinux still has a custom docker-versions.md, so we lost some info -- give me a sec to move that info back into content.md.

[tianon]

(OK, comment above updated with the adjusted content.)

[Djelibeybi]

@tianon looks 👍 to me. Nice work.

[tianon]

Thanks @Djelibeybi ❤️ -- it's been a lot of work today to track down and corroborate all this information 😅, but I think it'll really be helpful to our users (and upstreams who aren't maintaining their associated image)

[tianon]

@mlhess @CashWilliams how's this? ❤️ (this is the change I mentioned over in #886 (comment))

Quick reference

• Where to get help:
  the Docker Community Forums, the Docker Community Slack, or Stack Overflow

• Where to file issues:
  https://github.com/docker-library/drupal/issues

• Maintained by:
  the Docker Community (not the Drupal Community or the Drupal Security Team)

• Published image artifact details:
  repo-info repo's repos/drupal/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/drupal
  official-images repo's library/drupal file (history)

• Source of this description:
  docs repo's drupal/ directory (history)

• Supported Docker versions:
  the latest release (down to 1.6 on a best-effort basis)

[yosifkit]

Looks great to me. If any maintainer wishes to adjust their group name, PRs to change are always welcome.