Update build dependencies, improve README
Change-Id: I9b0b7b0cc6f5991075ce144564ce567916b6fe6f
diff --git a/README.md b/README.md
index 3118681..3aab7da 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,45 @@
+<div align="center">
+
+[<img alt height="65" src="_static/ndn-logo.svg"/>](https://named-data.net/)
+
# NDN Packet Format Specification
-## Prerequisites
+</div>
-To "compile" the specification in HTML format, you must first install the Sphinx documentation generator.
+This repository contains the base packet format specification of the Named Data
+Networking (NDN) protocol.
-If you're running Ubuntu Linux:
+An HTML version of the specification can be viewed online at
+<https://docs.named-data.net/NDN-packet-spec/>.
+
+## Compiling from source
+
+### Prerequisites
+
+To "compile" the specification in HTML format, you must first install the
+[Sphinx](https://www.sphinx-doc.org/en/master/) documentation generator and a
+few other dependencies. To do so, first make sure that the following packages
+are installed and up to date:
+
+* make
+* python 3.8 or later
+* pip
+
+For instance, on Ubuntu Linux you can use the following commands:
sudo apt install make python3-pip
- pip3 install -U pip
- pip3 install -r requirements.txt
+ python3 -m pip install -U pip
-If you're running macOS or another operating system, see the instructions at https://www.sphinx-doc.org/en/master/usage/installation.html
+On other operating systems, you can either use your preferred package manager or
+follow [pip's installation instructions](https://pip.pypa.io/en/stable/installation/).
-## Compilation
+Finally, run:
+
+ python3 -m pip install -r requirements.txt
+
+to install the recommended version of Sphinx and its dependencies.
+
+### Compilation
Just type:
@@ -24,6 +51,8 @@
make latexpdf
-Sphinx will generate a `.tex` file and will try to create a `.pdf` document from it using `pdflatex` (which must be installed).
+Sphinx will generate a `.tex` file and will try to compile it into a PDF document
+using `latexmk` and `pdflatex` (which must be installed). If successful, the final
+`.pdf` file can be found in `_build/latex`.
For further options, type `make help`.