improve documentation

NOTICE.md

@@ -14,6 +14,8 @@ Our dependencies are (see [requirements.txt](requirements.txt)):
 
 We also use additional Python dependencies for development/testing/documentation (see [requirements-dev.txt](requirements-dev.txt)).
 
+The [tutorial notebook](docs/source/notebooks/ogb_biokg_demo.ipynb) make use of the [ogbl-biokg](https://ogb.stanford.edu/docs/linkprop/#ogbl-biokg) dataset, licensed under CC-0;
+
 ## Derived work
 
 This directory includes derived work from the following:

README.md

@@ -5,6 +5,8 @@ A Python toolbox to compute topological metrics and statistics for Knowledge Gra
 
 Documentation can be found at https://curly-barnacle-lnejye6.pages.github.io/
 
+For a walkthrough of the main functionalities, we provide an introductory [Jupyter notebook](docs/source/notebooks/ogb_biokg_demo.ipynb).
+
 ## Usage
 
 Tested on Ubuntu 20.04, Python >=3.8
@@ -18,5 +20,5 @@ pip install git+ssh://[email protected]/graphcore-research/kg-topology-toolbox
 
 4\. Import and use:
 ```python
-from kg_topology_toolbox import TopologyToolbox
+from kg_topology_toolbox import KGTopologyToolbox
 ```

docs/source/conf.py

@@ -36,6 +36,7 @@
     "sphinx.ext.intersphinx",
     "sphinx.ext.autosectionlabel",
     "myst_parser",
+    "nbsphinx",
 ]
 numpydoc_show_class_members = False
 todo_include_todos = True

docs/source/index.rst

@@ -8,4 +8,5 @@ KG Topology Toolbox
    :caption: Contents
 
    User guide <user_guide>
+   notebooks/ogb_biokg_demo
    API reference <API_reference>