docs: add badges to README, update various URLs
And remove reference to inaccessible video
Change-Id: I3ea826ac393847226d760002d700ae1ee648ff71
diff --git a/docs/hackathon.rst b/docs/hackathon.rst
index 625e3d6..9f88824 100644
--- a/docs/hackathon.rst
+++ b/docs/hackathon.rst
@@ -1,10 +1,10 @@
Past NDN Hackathon projects
===========================
-- 1st NDN Hackathon: `NFD integration test <http://ndncomm.github.io/mini-ndn/>`_.
+- 1st NDN Hackathon: `NFD integration tests <https://ndncomm.github.io/mini-ndn/>`_.
- 2st NDN Hackathon: `Mini-NDN metrics <https://github.com/2nd-ndn-hackathon/mini-ndn-metrics>`_.
- 3rd NDN Hackathon: `Mini-NDN cluster <https://github.com/3rd-ndn-hackathon/mini-NDN-cluster>`_.
- 4th NDN Hackathon: `Mini-NDN wifi <https://github.com/4th-ndn-hackathon/Mini-NDN-Wi-Fi>`_.
- 7th NDN Hackathon: `Mini-NDN documentation <https://github.com/7th-ndn-hackathon/mini-ndn-documentation>`_.
- 11th NDN Hackathon: `Mini-NDN improvements <https://11th-ndn-hackathon.named-data.net/hacks.html#8-mini-ndn-improvements>`_.
-- 12th NDN Hackathon: `Mini-NDN improvements and Refactoring <https://12th-ndn-hackathon.named-data.net/hacks.html#7-mini-ndn-improvements>`_.
\ No newline at end of file
+- 12th NDN Hackathon: `Mini-NDN improvements and refactoring <https://12th-ndn-hackathon.named-data.net/hacks.html#7-mini-ndn-improvements>`_.
diff --git a/docs/index.rst b/docs/index.rst
index 18ae23e..7175a28 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,8 +1,3 @@
-.. Mini-NDN documentation master file, created by
- sphinx-quickstart on Mon Sep 23 11:15:54 2019.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
Mini-NDN: A Mininet-based NDN emulator
======================================
@@ -23,9 +18,9 @@
Helpful Links
-------------
-* `NDN Website <http://named-data.net/>`_
-* `NDN Contributor's Guide <https://github.com/named-data/NFD/blob/master/CONTRIBUTING.md>`_
-* `Mininet Documentation <http://mininet.org/>`_
-* `Mini-NDN redmine <https://redmine.named-data.net/projects/mini-ndn>`_
-* `Mailing list <http://www.lists.cs.ucla.edu/mailman/listinfo/mini-ndn>`_
+* `NDN Website <https://named-data.net/>`__
+* `NDN Contributor's Guide <https://github.com/named-data/.github/blob/main/CONTRIBUTING.md>`__
+* `Mininet Documentation <https://mininet.org/>`__
+* `Mini-NDN redmine <https://redmine.named-data.net/projects/mini-ndn>`__
+* `Mailing list <https://www.lists.cs.ucla.edu/mailman/listinfo/mini-ndn>`__
* :doc:`Mini-NDN Team <authors>`
diff --git a/docs/install.rst b/docs/install.rst
index 90bcc58..3f66750 100644
--- a/docs/install.rst
+++ b/docs/install.rst
@@ -17,8 +17,8 @@
Using Docker
------------
-You can use the nightly build from GitHub package registry
-::
+You can use the nightly build from GitHub package registry::
+
docker run -m 4g --cpus=4 -it --privileged \
-v /lib/modules:/lib/modules \
ghcr.io/named-data/mini-ndn:master bash
@@ -42,9 +42,10 @@
Additional recommendations
--------------------------
+
- It is recommended to set reasonable constraints on memory (`-m`) and CPU cores (`--cpus`), especially on less
powerful or non-dedicated systems.
-- `--privileged` is mandatory for underlying `Mininet <http://mininet.org/>`_ to utilize the virtual switch
+- `--privileged` is mandatory for underlying `Mininet <https://mininet.org/>`__ to utilize the virtual switch
- The root directory on `run` is `/mini-ndn`, which contains the installation and examples.
- The GUI may not work for now due to docker and xterm setup issues and is independent from Mini-NDN.
If you intend to run the GUI, pass `-e DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix` to the `docker run` command.
@@ -67,7 +68,7 @@
- `NDN Essential Tools (ndn-tools) <https://github.com/named-data/ndn-tools>`_
- `NDN Traffic Generator <https://github.com/named-data/ndn-traffic-generator>`_
- `infoedit <https://github.com/NDN-Routing/infoedit>`_
-- `Mininet <http://mininet.org/>`_
+- `Mininet <https://mininet.org/>`_
- `Mininet-WiFi <https://mininet-wifi.github.io/>`_ (optional)
To install Mini-NDN and its dependencies, clone this repository and run:
@@ -247,4 +248,4 @@
The gpsd application included currently is based on in-progress work and
is not treated as part of the main dependencies. To use it, install the
`gpsd` and `nc` (netcat) from your package manager, if not already present,
-to enable the functionality.
\ No newline at end of file
+to enable the functionality.
diff --git a/docs/introduction.rst b/docs/introduction.rst
index fe19ad8..ae5a63b 100644
--- a/docs/introduction.rst
+++ b/docs/introduction.rst
@@ -1,14 +1,14 @@
Introduction
-=================
-
-If you are new to the NDN community of software generally, read the
-`Contributor's Guide <https://github.com/named-data/NFD/blob/master/CONTRIBUTING.md>`_.
+============
What is Mini-NDN?
-----------------
Mini-NDN is a lightweight networking emulation tool that enables testing, experimentation, and
-research on the NDN platform. It was initially based on `Mini-CCNx <https://github.com/chesteve/mn-ccnx>`_ which was a fork of `Mininet <https://github.com/mininet/mininet>`_. Mini-NDN uses the NDN libraries, NFD, NLSR, and tools released by the `NDN project <http://named-data.net/codebase/platform/>`_ to emulate an NDN network on a single system.
+research on the NDN platform. It was initially based on `Mini-CCNx <https://github.com/chesteve/mn-ccnx>`__
+which was a fork of `Mininet <https://github.com/mininet/mininet>`__. Mini-NDN uses the NDN libraries,
+NFD, NLSR, and tools released by the `NDN project <https://named-data.net/codebase/platform/>`__
+to emulate an NDN network on a single system.
The first release of Mini-NDN is developed by members of the NSF-sponsored NDN project team.
Mini-NDN is open to contribution from the public.
@@ -18,23 +18,16 @@
License
_______
-Mini-NDN is open and free software licensed under the GPL 3.0 license. Mini-NDN is free to all
-users and developers. For more information about licensing details and limitations,
-please refer to COPYING.md.
+Mini-NDN is free and open source software distributed under the GNU General Public License
+version 3. For more information about licensing details and limitations, please refer to
+`COPYING.md <https://github.com/named-data/mini-ndn/blob/master/COPYING.md>`__.
Feedback/Mailing List
_____________________
Bug reports and feedback are highly appreciated and can be made through our
-`Redmine site <http://redmine.named-data.net/projects/mini-ndn>`_ and the
-`mini-ndn mailing list <http://www.lists.cs.ucla.edu/mailman/listinfo/mini-ndn>`_.
+`Redmine site <https://redmine.named-data.net/projects/mini-ndn>`__ and the
+`mini-ndn mailing list <https://www.lists.cs.ucla.edu/mailman/listinfo/mini-ndn>`__.
-Video
-_____
-
-.. raw:: html
-
- <div id="video-container" class="col-md-6 ">
- <p>Mini-NDN (content maybe outdated)</p>
- <iframe width="600" height="345" src="https://www.youtube.com/embed/UxHPqaUwefg" frameborder="0" allowfullscreen=""></iframe>
- </div>
\ No newline at end of file
+If you are new to the NDN software community and intend to contribute to the codebase, please read our
+`Contributor's Guide <https://github.com/named-data/.github/blob/main/CONTRIBUTING.md>`__.
diff --git a/docs/videos.rst b/docs/videos.rst
index db97952..0783f21 100644
--- a/docs/videos.rst
+++ b/docs/videos.rst
@@ -3,16 +3,20 @@
May be outdated since version 0.5.0.
+Mini-NDN Demo at ACM ICN 2017
+-----------------------------
+
.. raw:: html
- <div id="video-container" class="col-md-6 ">
- <p>Mini-NDN Demo at ACM, 2017</p>
- <iframe width="400" height="230" src="https://www.youtube.com/embed/xYRPHZe18o0" frameborder="0" allowfullscreen=""></iframe>
+ <div id="video-container" class="col-md-6">
+ <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/xYRPHZe18o0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
</div>
+Mini-NDN Overview
+-----------------
+
.. raw:: html
- <div id="video-container" class="col-md-6 "">
- <p>Mini-NDN Overview </p>
- <iframe width="400" height="230" src="https://www.youtube.com/embed/Da7t8yBWzv0" frameborder="0" allowfullscreen="">
+ <div id="video-container" class="col-md-6">
+ <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/Da7t8yBWzv0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
</div>