doc: simplify README structure and update content

Author: ranukund

README.md

@@ -18,18 +18,33 @@ AMD\* GPU, OpenPOWER\* Power ISA (PPC64), IBMz\* (s390x), and RISC-V.
 
 oneDNN is intended for deep learning applications and framework
 developers interested in improving application performance on CPUs and GPUs.
-Deep learning practitioners should use one of the
-[applications enabled with oneDNN](#applications-enabled-with-onednn).
+
+Deep learning practitioners should use one of the applications enabled with oneDNN:
+
+* [Apache SINGA](https://singa.apache.org)
+* [DeepLearning4J\*](https://deeplearning4j.konduit.ai)
+* [Flashlight\*](https://github.com/flashlight/flashlight)
+* [MATLAB\* Deep Learning Toolbox](https://www.mathworks.com/help/deeplearning)
+* [ONNX Runtime](https://onnxruntime.ai)
+* [OpenVINO(TM) toolkit](https://github.com/openvinotoolkit/openvino)
+* [PaddlePaddle\*](http://www.paddlepaddle.org)
+* [PyTorch\*](https://pytorch.org). Intel GPU support and additional
+optimizations are available with [Intel® Extension for PyTorch*].
+* [Tensorflow\*](https://www.tensorflow.org). Intel GPU support and additional
+optimizations are available with [Intel® Extension for TensorFlow*].
+
+[Intel® Extension for PyTorch*]: https://github.com/intel/intel-extension-for-pytorch
+[Intel® Extension for TensorFlow*]: https://github.com/intel/intel-extension-for-tensorflow
 
 [UXL Foundation]: http://www.uxlfoundation.org
-[oneAPI specification]: https://spec.oneapi.io
+[oneAPI specification]: https://oneapi-spec.uxlfoundation.org/specifications/oneapi/latest/elements/onednn/source/
 
 # Table of Contents
 
 - [Documentation](#documentation)
-- [Installation](#installation)
 - [System Requirements](#system-requirements)
-- [Applications Enabled with oneDNN](#applications-enabled-with-onednn)
+- [Installation](#installation)
+- [Validated Configurations](#validated-configurations)
 - [Governance](#governance)
 - [Support](#support)
 - [Contributing](#contributing)
@@ -39,32 +54,19 @@ Deep learning practitioners should use one of the
 
 # Documentation
 
-* [Developer Guide] explains the programming model, supported functionality,
-  and implementation details, and includes annotated examples.
-* [API Reference] provides a comprehensive reference of the library API.
+* [oneDNN Developer Guide and Reference] explains the programming
+  model, supported functionality, implementation details, and includes
+  annotated examples.
+* [API Reference] provides a comprehensive reference of the library
+  API.
+* [Release Notes] explains the new features, performance
+  optimizations, and improvements implemented in each version of
+  oneDNN.
 
-[Developer Guide]: https://oneapi-src.github.io/oneDNN
+[oneDNN Developer Guide and Reference]: https://oneapi-src.github.io/oneDNN
 [API Reference]: https://oneapi-src.github.io/oneDNN/group_dnnl_api.html
+[Release Notes]: https://github.com/oneapi-src/oneDNN/releases
 
-# Installation
-
-Binary distribution of this software is available in:
-* [Anaconda]
-* [Intel oneAPI]
-
-The packages do not include library dependencies and these need to be resolved
-in the application at build time. See the [System Requirements] section below
-and the [Build Options] section in the [Developer Guide] for more details on
-CPU and GPU runtimes.
-
-If the configuration you need is not available, you can
-[build the library from source][Build from Source].
-
-[Anaconda]: https://anaconda.org/conda-forge/onednn
-[Intel oneAPI]: https://www.intel.com/content/www/us/en/developer/tools/oneapi/onednn.html
-[System Requirements]: #system-requirements
-[Build Options]: https://oneapi-src.github.io/oneDNN/dev_guide_build_options.html
-[Build from Source]: https://oneapi-src.github.io/oneDNN/dev_guide_build.html
 
 # System Requirements
 
@@ -239,12 +241,12 @@ is enabled:
 [timeout detection and recovery]: https://learn.microsoft.com/en-us/windows-hardware/drivers/display/timeout-detection-and-recovery
 [TdrDelay]: https://learn.microsoft.com/en-us/windows-hardware/drivers/display/tdr-registry-keys#tdrdelay
 
-### Runtime Dependencies
+## Runtime Dependencies
 
 When oneDNN is built from source, the library runtime dependencies and specific
 versions are defined by the build environment.
 
-#### Linux
+### Linux
 
 Common dependencies:
 * GNU C Library (`libc.so`)
@@ -265,7 +267,7 @@ Runtime-specific dependencies:
 | `DNNL_GPU_RUNTIME=OCL`   | any                           | OpenCL loader (`libOpenCL.so`)
 | `DNNL_GPU_RUNTIME=SYCL`  | Intel oneAPI DPC++ Compiler   | Intel oneAPI DPC++ Compiler runtime (`libsycl.so`), OpenCL loader (`libOpenCL.so`), oneAPI Level Zero loader (`libze_loader.so`)
 
-#### Windows
+### Windows
 
 Common dependencies:
 * Microsoft Visual C++ Redistributable (`msvcrt.dll`)
@@ -281,7 +283,7 @@ Runtime-specific dependencies:
 | `DNNL_GPU_RUNTIME=OCL`   | any                           | OpenCL loader (`OpenCL.dll`)
 | `DNNL_GPU_RUNTIME=SYCL`  | Intel oneAPI DPC++ Compiler   | Intel oneAPI DPC++ Compiler runtime (`sycl.dll`), OpenCL loader (`OpenCL.dll`), oneAPI Level Zero loader (`ze_loader.dll`)
 
-#### macOS
+### macOS
 
 Common dependencies:
 * System C/C++ runtime (`libc++.dylib`, `libSystem.dylib`)
@@ -293,7 +295,28 @@ Runtime-specific dependencies:
 | `DNNL_CPU_RUNTIME=OMP` | Intel C/C++ Compiler          | Intel OpenMP runtime (`libiomp5.dylib`)
 | `DNNL_CPU_RUNTIME=TBB` | any                           | TBB (`libtbb.dylib`)
 
-### Validated Configurations
+# Installation
+
+You can download and install the oneDNN library using one of the following options:
+
+- Binary Distribution: You can download pre-built binary packages from
+  the following sources:
+    - [conda-forge]: If the configuration you need is not available on
+      the conda-forge channel, you can build the library using the
+      Source Distribution.
+    - Intel oneAPI:
+       - [Intel® oneAPI Base Toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit-download.htm)
+       - [Intel® oneDNN standalone package](https://www.intel.com/content/www/us/en/developer/tools/oneapi/onednn-download.html)
+
+- Source Distribution: You can build the library from source by
+  following the instructions on the [Build from Source] page.
+
+[conda-forge]: https://anaconda.org/conda-forge/onednn
+[System Requirements]: #system-requirements
+[Build Options]: https://oneapi-src.github.io/oneDNN/dev_guide_build_options.html
+[Build from Source]: https://oneapi-src.github.io/oneDNN/dev_guide_build.html
+
+# Validated Configurations
 
 x86-64 CPU engine was validated on RedHat\* Enterprise Linux 8 with
 * GNU Compiler Collection 8.5, 9.5, 11.1, 11.3
@@ -334,24 +357,6 @@ time of release
 [Intel Arc & Iris Xe Graphics Driver]: https://www.intel.com/content/www/us/en/download/785597/intel-arc-iris-xe-graphics-windows.html
 [Arm Compiler for Linux]: https://developer.arm.com/Tools%20and%20Software/Arm%20Compiler%20for%20Linux
 
-# Applications Enabled with oneDNN
-
-* [Apache\* MXNet](https://mxnet.apache.org)
-* [Apache SINGA](https://singa.apache.org)
-* [DeepLearning4J\*](https://deeplearning4j.konduit.ai)
-* [Flashlight\*](https://github.com/flashlight/flashlight)
-* [Korali](https://github.com/cselab/korali)
-* [MATLAB\* Deep Learning Toolbox](https://www.mathworks.com/help/deeplearning)
-* [ONNX Runtime](https://onnxruntime.ai)
-* [OpenVINO(TM) toolkit](https://github.com/openvinotoolkit/openvino)
-* [PaddlePaddle\*](http://www.paddlepaddle.org)
-* [PyTorch\*](https://pytorch.org). Intel GPU support and additional
-optimizations are available with [Intel Extension for PyTorch].
-* [Tensorflow\*](https://www.tensorflow.org). Intel GPU support and additional
-optimizations are available with [Intel Extension for Tensorflow].
-
-[Intel Extension for PyTorch]: https://github.com/intel/intel-extension-for-pytorch
-[Intel Extension for Tensorflow]: https://github.com/intel/intel-extension-for-tensorflow
 
 # Support
 
@@ -387,21 +392,13 @@ schedule and work already in progress towards future milestones in Github's
 [Milestones] section. If you are looking for a specific task to start,
 consider selecting from issues that are marked with the [help wanted] label.
 
-If you have an idea on how to improve the library:
-* For changes impacting the public API or library overall, such as adding new
-primitives or changes to the architecture, submit an [RFC pull request].
-* Ensure that the changes are consistent with the [code contribution guidelines]
-and [coding standards].
-* Ensure that you can build the product and run all the examples with your
-patch.
-* Submit a [pull request].
-
-For additional details, see [contribution guidelines](CONTRIBUTING.md). You can
-also contact oneDNN developers and maintainers via [UXL Foundation Slack] using
-[#onednn] channel.
 
-This project is intended to be a safe, welcoming space for collaboration, and
-contributors are expected to adhere to the
+See [contribution guidelines](CONTRIBUTING.md) to start contributing
+to oneDNN. You can also contact oneDNN developers and maintainers via
+[UXL Foundation Slack] using [#onednn] channel.
+
+This project is intended to be a safe, welcoming space for
+collaboration, and contributors are expected to adhere to the
 [Contributor Covenant](CODE_OF_CONDUCT.md) code of conduct.
 
 [RFC pull request]: https://github.com/oneapi-src/oneDNN/tree/rfcs
@@ -411,13 +408,15 @@ contributors are expected to adhere to the
 [Milestones]: https://github.com/oneapi-src/oneDNN/milestones
 [help wanted]: https://github.com/oneapi-src/oneDNN/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22
 
+
 # License
 
-oneDNN is licensed under [Apache License Version 2.0](LICENSE). Refer to the
-"[LICENSE](LICENSE)" file for the full license text and copyright notice.
+oneDNN is licensed under [Apache License Version 2.0](LICENSE). Refer
+to the "[LICENSE](LICENSE)" file for the full license text and
+copyright notice.
 
-This distribution includes third party software governed by separate license
-terms.
+This distribution includes third party software governed by separate
+license terms.
 
 3-clause BSD license:
 * [Xbyak](https://github.com/herumi/xbyak)
@@ -446,17 +445,17 @@ and OpenCL Driver](https://github.com/intel/compute-runtime)
 Interface](https://github.com/intel/metrics-discovery)
 * [spdlog](https://github.com/gabime/spdlog)
 
-This third party software, even if included with the distribution of
-the Intel software, may be governed by separate license terms, including
-without limitation, third party license terms, other Intel software license
-terms, and open source software license terms. These separate license terms
-govern your use of the third party programs as set forth in the
-"[THIRD-PARTY-PROGRAMS](THIRD-PARTY-PROGRAMS)" file.
+This third-party software, even if included with the distribution of
+the Intel software, may be governed by separate license terms,
+including without limitation,third party license terms, other Intel
+software license terms, and open source software license terms. These
+separate license terms govern your use of the third party programs as
+set forth in the "[THIRD-PARTY-PROGRAMS](THIRD-PARTY-PROGRAMS)" file.
 
 # Security
 
 [Security Policy](SECURITY.md) outlines our guidelines and procedures
-for ensuring the highest level of Security and trust for our users
+for ensuring the highest level of security and trust for our users
 who consume oneDNN.
 
 # Trademark Information