docs: Adding documentation skeleton
Change-Id: Ia54efcddcf121f60cc32312de4f9d0e630992ffe
diff --git a/docs/INSTALL.rst b/docs/INSTALL.rst
new file mode 100644
index 0000000..6b38d71
--- /dev/null
+++ b/docs/INSTALL.rst
@@ -0,0 +1,115 @@
+.. _NDNS Installation Instructions:
+
+NDNS Installation Instructions
+=============================
+
+Prerequisites
+-------------
+
+- `ndn-cxx library <https://github.com/named-data/ndn-cxx>`__
+ and its requirements:
+
+ - ``libcrypto``
+ - ``libsqlite3``
+ - ``libcrypto++``
+ - ``pkg-config``
+ - Boost libraries (>= 1.48)
+ - OSX Security framework (on OSX platform only)
+
+ Refer to `Getting started with ndn-cxx <http://named-data.net/doc/ndn-cxx/current/INSTALL.html>`_
+ for detailed installation instructions of the library.
+
+To build manpages and API documentation:
+
+- ``doxygen``
+- ``graphviz``
+- ``python-sphinx``
+
+ On OS X 10.8 and 10.9 with macports:
+
+ ::
+
+ sudo port install doxygen graphviz py27-sphinx sphinx_select
+ sudo port select sphinx py27-sphinx
+
+ On Ubuntu >= 12.04:
+
+ ::
+
+ sudo apt-get install doxygen graphviz python-sphinx
+
+Build
+-----
+
+The following commands should be used to build NDNS:
+
+::
+
+ ./waf configure
+ ./waf
+ sudo ./waf install
+
+Refer to ``./waf --help`` for more options that can be used during ``configure`` stage and
+how to properly configure and run NDNS.
+
+In some configurations, configuration step may require small modification. For example, on
+OSX that uses macports (correct the path if macports was not installed in the default path
+``/opt/local``):
+
+::
+
+ export PKG_CONFIG_PATH=/opt/local/lib/pkgconfig:/usr/local/lib/pkgconfig:/usr/lib/pkgconfig:$PKG_CONFIG_PATH
+ ./waf configure
+ ./waf
+ sudo ./waf install
+
+On some Linux distributions (e.g., Fedora 20):
+
+::
+
+ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig:/usr/lib/pkgconfig:/usr/lib64/pkgconfig:$PKG_CONFIG_PATH
+ ./waf configure
+ ./waf
+ sudo ./waf install
+
+Debug symbols
++++++++++++++
+
+The default compiler flags enable debug symbols to be included in binaries. This
+potentially allows more meaningful debugging if NDNS or other tools happen to crash.
+
+If it is undesirable, default flags can be easily overridden. The following example shows
+how to completely disable debug symbols and configure NDNS to be installed into ``/usr``
+with configuration in ``/etc`` folder.
+
+::
+
+ CXXFLAGS="-O2" ./waf configure --prefix=/usr --sysconfdir=/etc
+ ./waf
+ sudo ./waf install
+
+Building documentation
+----------------------
+
+NDNS tutorials and API documentation can be built using the following commands:
+
+::
+
+ # Full set of documentation (tutorials + API) in build/docs
+ ./waf docs
+
+ # Only tutorials in `build/docs`
+ ./waf sphinx
+
+ # Only API docs in `build/docs/doxygen`
+ ./waf doxgyen
+
+
+Manpages are automatically created and installed during the normal build process
+(e.g., during ``./waf`` and ``./waf install``), if ``python-sphinx`` module is detected
+during ``./waf configure`` stage. By default, manpages are installed into
+``${PREFIX}/share/man`` (where default value for ``PREFIX`` is ``/usr/local``). This
+location can be changed during ``./waf configure`` stage using ``--prefix``,
+``--datarootdir``, or ``--mandir`` options.
+
+For more details, refer to ``./waf --help``.