Rework the ReadMe to be more quick-start friendly

[stefankiesz]

What was changed?
The ReadMe was re-worked to be more quick-start friendly. Missing information was added and made into tables. Typos and grammar issues were addressed.
(More details in the Overview section below.)

Why was it changed?
To improve the ReadMe and correct outstanding issues.

How was it changed?
By modifying the ReadMe document to address the above issues.

What testing was done for the changes?
The document was pasted into a spelling and grammar checker.

Overview

• Add a collapsible vertical table of contents
• Add a Quick Start section
• Extend samples instructions
• Add missing Windows instructions
• Fix incorrect dependency installation commands
• Add more links to resources and references
  • New links include: AWS KVS getting started page, AWS KVS FAQs page, GStreamer element docs, Java Producer SDK
  • Also added a link to Producer C in the Key Features section incase user does not need JNI nor GStreamer features
• Make the CMake Arguments section into a table and fix typos in the descriptions
• Make the kvssink parameters into a table, fix missing links, add in aws-region parameter
• Mention and show how to stream from file with the kvssink sample
• To the Quick Start section, add instructions for how/where to view the footage from the samples and link troubleshoot guides
• ...more misc. changes

Future Improvements

• Consider splitting the QuickStart instructions for building the SDK into build-with-dependencies a build-using-system-dependencies and demonstrate how to install the system dependencies and the correct versions.
• Improve upon and add to the Debugging/Troubleshooting section - likely should add more links to AWS docs. Specify Java version for JNI. Also should probably add a link to Java SDK and instructions if any are missing on that repo's ReadMe.
• Add installation commands to all the prerequisite packages such as git and cmake. This will likely only fit well if the QuickStart section gets restructured into 3 separate sections for each OS.
• Add a "Running Tests" section to show how to build and run the tests. Include details such as AWS authentication and how resources are managed when tests are running and failing.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[sirknightj]

Would suggest splitting this into 2 subsections:

1. Build from scratch (build with dependencies=ON)
2. Build using system libraries (build with dependencies=OFF). For this, you would also need to install the necessary dependencies using system package manager

[stefankiesz]

Going to add this to the PR description as a future addition to consider, but I'm not set on doing this quite yet since for the smoothest onboarding experience we would recommend to do build dependencies to ensure a supported version of a dependency library is being used.

[stefankiesz]

To add to that, it's not as simple as just including the install instructions with the correct versions: users might already have some of the dependency libraries installed with unsupported versions and there would be potential for CMake or pkgconfig to link the incorrect ones.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 0% with 105 lines in your changes missing coverage. Please review.

Project coverage is 16.30%. Comparing base (eeb392f) to head (03d8f84).
Report is 10 commits behind head on develop.

❗ Current head 03d8f84 differs from pull request most recent head 3bb045b

Please upload reports for the commit 3bb045b to get more accurate results.

Files	Patch %	Lines
samples/kvssink_gstreamer_sample.cpp	0.00%	50 Missing ⚠️
...mazonaws/kinesis/video/producer/jni/Parameters.cpp	0.00%	46 Missing ⚠️
src/gstreamer/gstkvssink.cpp	0.00%	8 Missing ⚠️
...s/video/producer/jni/KinesisVideoClientWrapper.cpp	0.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #1173      +/-   ##
===========================================
- Coverage    16.48%   16.30%   -0.18%     
===========================================
  Files           50       50              
  Lines         7019     7095      +76     
===========================================
  Hits          1157     1157              
- Misses        5862     5938      +76     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[sirknightj]

How come the gstreamer version is only specified in the windows? Does mac and linux requires certain gstreamer versions? Is this the only supported gstreamer version for windows?

[stefankiesz]

Likely not the only supported version, but for the windows build, we have relied on using the pkg-config library bundled with the gstreamer installation. We've found that some versions of gstreamer do not have the pkg-config library. I believe we may be able to switch to just using pkg-config-lite, installed via choco, then we can remove this version specifier.