docs(README): Updates README commands

Moves git clone section above install tools.
Updates two install tool versions that were broken.

Signed-off-by: Jonas Wood <[email protected]>

Author: jonaswood01

README.md

@@ -3,20 +3,24 @@ Processor SDK Documentation in Sphinx
 
 ## Instructions to build the project on Ubuntu
 
+### Clone the Git Repo
+
+    $ git clone https://github.com/TexasInstruments/processor-sdk-doc.git
+
 ### Install tools on Ubuntu
 
 Use the following command in a python virtual environment for a known working
 config:
 
-    # python3 -m pip install -r requirements.txt
+    $ cd processor-sdk-doc
+    $ python3 -m pip install -r requirements.txt
+
+> [!WARNING]
+> This is supported using Python v3.12/3.13. If you use a different Python version, some package versions in `requirements.txt` may not be compatible.
 
 OR you can use a docker container like the following:
     - [psdk-doc-docker](https://github.com/TexasInstruments/processor-sdk-doc/pkgs/container/processor-sdk-doc)
 
-### Clone the Git Repo
-
-    $ git clone https://github.com/TexasInstruments/processor-sdk-doc.git
-
 ### Build on Ubuntu
 
 To build the documentation a DEVFAMILY and OS must be specified as either an
@@ -51,23 +55,23 @@ Example build commands:
 
  - Build linux documentation for AM335X
 
-    $ make DEVFAMILY=AM335X OS=linux
+       $ make DEVFAMILY=AM335X OS=linux
 
  - Build android documentation for AM62X
 
-    $ make DEVFAMILY=AM62X OS=android
+       $ make DEVFAMILY=AM62X OS=android
 
  - Build debian documentation for AM62PX
 
-    $ make DEVFAMILY=AM62PX OS=debian
+       $ make DEVFAMILY=AM62PX OS=debian
 
 ### HTML Page Output
 
 Open the index page in a web browser
 
     linux:   ./build/processor-sdk-linux-<FAMILY>/esd/docs/[version]/index.html
     android: ./build/processor-sdk-android-<FAMILY>/esd/docs/[version]/index.html
-    debian: ./build/processor-sdk-debian-<FAMILY>/esd/docs/[version]/index.html
+    debian:  ./build/processor-sdk-debian-<FAMILY>/esd/docs/[version]/index.html
 
 ## Live Preview on GitHub Pages
 

requirements.txt

@@ -20,7 +20,7 @@ requests==2.32.3
 rich==13.9.4
 roman-numerals-py==3.1.0
 rstcheck==6.2.4
-rstcheck-core @ git+https://github.com/StaticRocket/rstcheck-core.git@b7bdfd920a023e24ffe5e560c706954656c366f0
+rstcheck-core==1.2.1
 shellingham==1.5.4
 snowballstemmer==2.2.0
 Sphinx==8.2.3