Update Oracle Linux docs to better reflect current reality

Signed-off-by: Avi Miller <[email protected]>

Author: Djelibeybi

oraclelinux/content.md

@@ -4,43 +4,40 @@
 
 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
+## Changelog
 
-The Oracle Linux images are intended for use in the **FROM** field of a downstream `Dockerfile`. For example, to use the latest optimized Oracle Linux 7 image, specify `FROM %%IMAGE%%:7-slim`.
+Oracle maintains a [CHANGELOG](https://github.com/oracle/container-images/blob/main/CHANGELOG.md) that documents by release date the errata applied and any CVE(s) that are mitigated in each update to the official images.
 
-## Removal of `latest` tag
+## How to use these images
 
-The `latest` tag was removed from the Oracle Linux official images in June 2020 to reduce confusion. Downstream images using `oraclelinux:latest` or no tag should be updated to `oraclelinux:7` for future builds. Note that Oracle recommends using the `-slim` variants for the smallest possible image size.
+The Oracle Linux images are intended for use in the **FROM** field of a downstream `Dockerfile`. For example, to use the latest optimized Oracle Linux 8 i mage, specify `FROM %%IMAGE%%:8`.
 
-## Official Resources
+### Removal of `latest` tag
 
--	[Learn more about Oracle Linux](https://oracle.com/linux)
--	[Unbreakable Linux Network](https://linux.oracle.com)
--	[Oracle Linux Yum Server](http://yum.oracle.com)
+The `latest` tag was removed from the Oracle Linux official images in June 2020 to avoid breaking any downstream images caused by backwards-incompatible changes introduced by the release of a new version. Downstream images must specify the version, i.e. `oraclelinux:7` or `oraclelinux:8`.
 
-## Social media resources
+### Differences between `oraclelinux:8` and `oraclelinux:8-slim`
 
--	[Twitter](https://twitter.com/OracleLinux)
--	[Facebook](https://www.facebook.com/OracleLinux)
--	[YouTube](https://www.youtube.com/user/OracleLinuxChannel)
--	[Blog](http://blogs.oracle.com/linux)
+Oracle recommends using `oraclelinux:8` for most images that extend Oracle Linux 8.
 
-## Customer Support
+The `oraclelinux:8-slim` variant is intended primarily to provide "just enough user space" for statically compiled binaries or microservices. Use of the `8-slim` variant is discouraged for general purposes, due to the inclusion of `microdnf` in place of `dnf` and signficantly reduced locale data.
 
-Oracle provides support to Oracle Linux subscription customers via the [My Oracle Support](https://support.oracle.com) 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.
+### Differences between `oraclelinux:7` and `oraclelinux:7-slim`
 
-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 Oracle Container Runtime for Docker installed from the Unbreakable Linux Network (ULN) or the Oracle Linux yum server.
+For images that want an Oracle Linux 7 user space, Oracle recommends using `oraclelinux:7-slim` as the base layer as it contains just enough packages for `yum` to be able to install more packages.
 
-Oracle Linux users without an active support subscription can use either the Oracle distributed version of Oracle Container Runtime for Docker or the upstream version distributed by Docker. Support is limited to the community-based options outlined below.
+The `oraclelinux:7` images is based on the package set of what would be installed on a bare-metal server when performing a Minimal install of Oracle Linux.
 
-### Oracle Linux 7
+## Official Resources
+
+-	[Oracle Linux documentation](https://docs.oracle.com/en/operating-systems/oracle-linux/index.html)
+-	[Oracle Linux Yum Server](http://yum.oracle.com)
+-	[Unbreakable Linux Network](https://linux.oracle.com)
 
-Please review the [additional Linux programs supported under Oracle Linux support](https://docs.oracle.com/cd/E52668_01/E63013/html/ol7-lic-addl-packages.html) chapter for more information on the scope of support for the Oracle Container Runtime for Docker.
+## Customer Support
 
-Please review the [Oracle Container Runtime for Docker User's Guide](https://docs.oracle.com/cd/E52668_01/E87205/html/index.html) for details on how to install or upgrade the Oracle Container Runtime for Docker on Oracle Linux 7.
+Oracle provides support to Oracle Linux subscription customers via the [My Oracle Support](https://support.oracle.com) portal. The Oracle Linux container 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 container.
 
 ## Community Support
 
-For Oracle Linux users without a paid support subscription, the following resources are available:
-
--	The [Oracle Linux space](https://community.oracle.com/community/groundbreakers/server_&_storage_systems/linux/oracle_linux) on the [Oracle Technology Network Community](https://community.oracle.com/welcome).
+Users without an Oracle Linux support subscription should either [open an issue](https://github.com/oracle/container-images/issues) or [start a discussion](https://github.com/oracle/container-images/discussions) in the [Oracle Linux container image repository](https://github.com/oracle/container-images) on GitHub.

oraclelinux/logo.png

@@ -1 +1 @@
-[the Oracle Linux Product Team](%%GITHUB-REPO%%)
+[the Oracle Linux Container Team](%%GITHUB-REPO%%)