Merge pull request #68 from DerwenAI/update

#32 docs drafts

README.md

@@ -81,8 +81,8 @@ graph libraries in Python:
 
 ## Build Instructions
 
-Note: most use cases won't need to build this package locally, 
-and instead will simply install directly from
+**Note: most use cases won't need to build this package locally.**
+Instead, simply install from
 [PyPi](https://pypi.python.org/pypi/kglab)
 or [Conda](https://docs.conda.io/).
 
@@ -122,6 +122,8 @@ To generate documentation pages, this project uses:
 
   * [`MkDocs`](https://www.mkdocs.org/)
   * [`makedocs-material`](https://squidfunk.github.io/mkdocs-material/)
+  * [`MathJax`](https://www.mathjax.org/)
+  * [`pymdown-extensions`](https://facelessuser.github.io/pymdown-extensions/)
   * [`Jupyter`](https://jupyter.org/install)
   * [`nbconvert`](https://nbconvert.readthedocs.io/)
   * [`Selenium`](https://selenium-python.readthedocs.io/)

docs/ack.md

@@ -1,6 +1,6 @@
 # Acknowledgements
 
-## Kudos
+## Contributors and Supporters
 
 Many thanks to contributors:
 [@jake-aft](https://github.com/jake-aft),

docs/biblio.md

@@ -1,168 +1,187 @@
 # Bibliography
 
-## A
+## – A –
 
 ### alexopoulos2020
 
 [*Semantic Modeling for Data: Avoiding Pitfalls and Breaking Dilemmas*](https://www.goodreads.com/book/show/53483743-semantic-modeling-for-data)  
-Panos Alexopoulos  
+**Panos Alexopoulos**  
 O'Reilly Media (2020)
 
 ### anderson2020dt
 
 [*Data Teams: A Unified Management Model for Successful Data-Focused Teams*](https://www.apress.com/us/book/9781484262276)  
-Jesse Anderson  
+**Jesse Anderson**  
 Apress (2020)
 
-## B
+## – B –
 
 ### bell2019
 
 [*Get Programming: Learn to code with Python*](https://www.manning.com/books/get-programming)  
-Ana Bell  
+**Ana Bell**  
 Manning (2018)
 
 ### breiman2001
 
 ["Statistical Modeling: The Two Cultures"](https://doi.org/10.1214/ss/1009213726)  
-Leo Breiman  
+**Leo Breiman**  
 *Statist. Sci.* 16:3 (2001)
 
 ### brewer2012cap
 
 ["CAP Twelve years later: How the 'Rules' have Changed"](https://doi.org/10.1109/MC.2012.37)  
-Eric Brewer  
+**Eric Brewer**  
 *Computer* 45:2 (2012)
 
-## C
+## – C –
 
 ### ceder2018
 
 [*The Quick Python Book, Third Edition*](https://www.manning.com/books/the-quick-python-book-third-edition)  
-Naomi Ceder  
+**Naomi Ceder**  
 Manning (2018)
 
 ### chollet2017
 
 [*Deep Learning with Python*](https://www.manning.com/books/deep-learning-with-python)  
-François Chollet  
+**François Chollet**  
 Manning (2017)
 
-## D
+## – D –
 
 ### das2020meta
 
 ["Metadata Day 2020"](https://metadataday2020.splashthat.com/)  
-Shirshanka Das, Paco Nathan, Nadiya Hayes, Joe M. Hellerstein,
-Kapil Surlaker, Chris Williams, Natasha F. Noy,
-Daniella Lowenberg, Ian Mulvany, Mark Grover, Alejandro Saucedo,
-Deborah L. McGuinness, Ted Habermann, Charles Smith, Julien Le Dem,
-Deepak Chandramouli, Igor Perisic, Sunheng Taing, Satyen Sangani,
-Aaron Kalb, Daniel Rincon Silva  
+**Shirshanka Das**, **Paco Nathan**, **Nadiya Hayes**, **Joe M. Hellerstein**,
+**Kapil Surlaker**, **Chris Williams**, **Natasha F. Noy**,
+**Daniella Lowenberg**, **Ian Mulvany**, **Mark Grover**, **Alejandro Saucedo**,
+**Deborah L. McGuinness**, **Ted Habermann**, **Charles Smith**, **Julien Le Dem**,
+**Deepak Chandramouli**, **Igor Perisic**, **Sunheng Taing**, **Satyen Sangani**,
+**Aaron Kalb**, **Daniel Rincon Silva**  
 LinkedIn (2020)
 
-## G
+## – G –
 
 ### gosnell2020
 
 [*The Practitioner's Guide to Graph Data*](https://www.goodreads.com/book/show/50204616-the-practitioner-s-guide-to-graph-data)  
-Denise Gosnell, Matthias Broecheler  
+**Denise Gosnell**, **Matthias Broecheler**  
 O'Reilly Media (2020)
 
 ### gruber1993ata
 
 ["A translation approach to portable ontology specifications"](https://doi.org/10.1006/KNAC.1993.1008)  
-Thomas R. Gruber  
-*Knowledge Acquisition* 5, pp. 199-220 (1993)
+**Thomas R. Gruber**  
+*Knowledge Acquisition* 5 (1993)
 
-## H
+## – H –
 
 ### hellersteinsgsa17
 
 ["Ground: A Data Context Service"](http://cidrdb.org/cidr2017/papers/p111-hellerstein-cidr17.pdf)  
-Joseph M. Hellerstein, Vikram Sreekanti, Joseph E. Gonzalez, James Dalton, Akon Dey, Sreyashi Nag, Krishna Ramachandran, Sudhanshu Arora, Arka Bhattacharyya, Shirshanka Das, Mark Donsky, Gabriel Fierro, Chang She, Carl Steinbach, Venkat Subramanian, Eric Sun  
+**Joseph M. Hellerstein**, **Vikram Sreekanti**, **Joseph E. Gonzalez**, 
+**James Dalton**, **Akon Dey**, **Sreyashi Nag**, **Krishna Ramachandran**, 
+**Sudhanshu Arora**, **Arka Bhattacharyya**, **Shirshanka Das**, 
+**Mark Donsky**, **Gabriel Fierro**, **Chang She**, **Carl Steinbach**, 
+**Venkat Subramanian**, **Eric Sun**  
 *CIDR* (2017)
 
 ### hogan2020knowledge
 
 ["Knowledge Graphs"](https://arxiv.org/abs/2003.02320)  
-Aidan Hogan, Eva Blomqvist, Michael Cochez, Claudia d'Amato, Gerard de Melo, Claudio Gutierrez, José Emilio Labra Gayo, Sabrina Kirrane, Sebastian Neumaier, Axel Polleres, Roberto Navigli, Axel-Cyrille Ngonga Ngomo, Sabbir M. Rashid, Anisa Rula, Lukas Schmelzeisen, Juan Sequeda, Steffen Staab, Antoine Zimmermann  
+**Aidan Hogan**, **Eva Blomqvist**, **Michael Cochez**, **Claudia d'Amato**,
+**Gerard de Melo**, **Claudio Gutierrez**, **José Emilio Labra Gayo**,
+**Sabrina Kirrane**, **Sebastian Neumaier**, **Axel Polleres**,
+**Roberto Navigli**, **Axel-Cyrille Ngonga Ngomo**, **Sabbir M. Rashid**,
+**Anisa Rula**, **Lukas Schmelzeisen**, **Juan Sequeda**, **Steffen Staab**,
+**Antoine Zimmermann**  
 *arXiv* (2020)
 
-## J
+## – J –
 
 ### jonas2019cloud
 
 ["Cloud Programming Simplified: A Berkeley View on Serverless Computing"](https://arxiv.org/abs/1902.03383)  
-Eric Jonas, Johann Schleier-Smith, Vikram Sreekanti, Chia-Che Tsai, Anurag Khandelwal, Qifan Pu, Vaishaal Shankar, Joao Carreira, Karl Krauth, Neeraja Yadwadkar, Joseph E. Gonzalez, Raluca Ada Popa, Ion Stoica, David A. Patterson  
+**Eric Jonas**, **Johann Schleier-Smith**, **Vikram Sreekanti**,
+**Chia-Che Tsai**, **Anurag Khandelwal**, **Qifan Pu**, **Vaishaal Shankar**,
+**Joao Carreira**, **Karl Krauth**, **Neeraja Yadwadkar**, **Joseph E. Gonzalez**,
+**Raluca Ada Popa**, **Ion Stoica**, **David A. Patterson**  
 *arXiv* (2019)
 
-## K
+## – K –
 
 ### kreps2014
 
 [*I Heart Logs: Event Data, Stream Processing, and Data Integration*](https://www.confluent.io/ebook/i-heart-logs-event-data-stream-processing-and-data-integration/)  
-Jay Kreps  
+**Jay Kreps**  
 O'Reilly Media (2014)
 
-## L
+## – L –
+
+### ledem2013hadoop
+
+["Parquet: Columnar storage for the people""](https://www.slideshare.net/julienledem/parquet-hadoop-summit-2013)  
+**Julien Le Dem**  
+*Hadoop Summit* (2013)
 
 ### lenat1982aaai
 
 ["Heuretics: Theoretical and Experimental Study of Heuristic Rules"](https://www.aaai.org/Library/AAAI/1982/aaai82-038.php)  
-Douglas B. Lenat  
+**Douglas B. Lenat**  
 AAAI (1982)
 
 ### lenat1984ai
 
 ["Why AM and Eurisko appear to work"](https://doi.org/10.1016/0004-3702(84)90016-X)  
-Douglas B. Lenat, John Seely Brown  
+**Douglas B. Lenat**, **John Seely Brown**  
 *Artificial Intelligence* 23:3 (1984)
 
 ### linden2006early
 
 ["Early Amazon: Splitting the website"](http://glinden.blogspot.com/2006/02/early-amazon-splitting-website.html)  
-Greg Linden  
+**Greg Linden**  
 *Geeking with Greg* (2006)
 
 ### lorica2020nlp
 
 ["2020 NLP Survey Report"](https://gradientflow.com/2020nlpsurvey/)  
-Ben Lorica, Paco Nathan  
+**Ben Lorica**, **Paco Nathan**  
 Gradient Flow (2020)
 
 ### lorica2020rai
 
 ["Responsible AI in Practice"](https://gradientflow.com/ResponsibleAI2020)
-Ben Lorica, Paco Nathan, Gina Blaber, Andrew Burt, Rumman Chowdhury, Yishay Carmiel  
+**Ben Lorica**, **Paco Nathan**, **Gina Blaber**, **Andrew Burt**,
+**Rumman Chowdhury**, **Yishay Carmiel**  
 Gradient Flow (2020)
 
-## N
+## – N –
 
 ### nathan2014jem
 
 [*Just Enough Math*](https://derwen.ai/jem)  
-Paco Nathan  
+**Paco Nathan**  
 O'Reilly Media (2014)
 
 ### negro2021
 
 [*Graph-Powered Machine Learning*](https://www.manning.com/books/graph-powered-machine-learning)  
-Alessandro Negro  
+**Alessandro Negro**  
 Manning (2021)
 
 ### noy2001ontology
 
 ["Ontology Development 101: A Guide to Creating Your First Ontology"](http://www-ksl.stanford.edu/people/dlm/papers/ontology-tutorial-noy-mcguinness-abstract.html)  
-Natalya F. Noy, Deborah L. McGuinness  
+**Natalya F. Noy**, **Deborah L. McGuinness**  
 *Stanford Knowledge Systems Laboratory Technical Report KSL-01-05* (2001)
 
-## P
+## – P –
 
 ### perrone2020network
 
 ["Network visualizations with Pyvis and VisJS"](https://arxiv.org/abs/2006.04951)  
-Giancarlo Perrone, Jose Unpingco, Haw-minn Lu  
+**Giancarlo Perrone**, **Jose Unpingco**, **Haw-minn Lu**  
 *arXiv* (2020)
 
 

docs/concepts.md

@@ -1,5 +1,10 @@
 # Graph Concepts
 
+## DRAFT: Work in progress
+
+This material is a work in progress, at "rough draft" stage.
+
+
 The primary abstractions used in **kglab** are based on a small set of
 Python classes.
 These class definitions can be subclassed and extended to handle

docs/glossary.md

@@ -1,6 +1,11 @@
 # Glossary
 
-## A
+## DRAFT: Work in progress
+
+This material is a work in progress, at "rough draft" stage.
+
+
+## – A –
 
 ### abstraction layer
 
@@ -10,15 +15,15 @@ A technology implementing a [*separation of concerns*](#separation-of-concerns)
 
 see: <https://en.wikipedia.org/wiki/Abstraction_layer>
 
-## C
+## – C –
 
 ### cloud computing
 
 see: <https://derwen.ai/d/cloud_computing>
 
 ### computable content
 
-## D
+## – D –
 
 ### data context
 
@@ -34,15 +39,15 @@ see: <https://derwen.ai/d/data_science>
 
 ### data strategy
 
-## G
+## – G –
 
 ### graph algorithms
 
 ### graph database
 
 ### graph-based data science
 
-## K
+## – K –
 
 ### KG
 
@@ -64,19 +69,19 @@ and its community
 
 ### knowledge graph embedding
 
-## M
+## – M –
 
 ### machine learning
 
 see: <https://derwen.ai/d/machine_learning>
 
-## N
+## – N –
 
 ### natural language
 
 see: <https://derwen.ai/d/natural_language>
 
-## O
+## – O –
 
 ### OSFA
 
@@ -85,13 +90,13 @@ abbr. "One size fits all", a common antipattern in technology
 
 see: <https://en.wikipedia.org/wiki/One_size_fits_all>
 
-## P
+## – P –
 
 ### probabilistic graph inference
 
 ### property graph
 
-## R
+## – R –
 
 ### RDF
 
@@ -103,13 +108,13 @@ abbr. *Resource Description Framework*
 
 see: <https://derwen.ai/d/reinforcement_learning>
 
-## S
+## – S –
 
 ### semantic technologies
 
 ### separation of concerns
 
-## W
+## – W –
 
 ### W3C
 

docs/javascripts/config.js

@@ -0,0 +1,12 @@
+window.MathJax = {
+    tex: {
+	inlineMath: [["\\(", "\\)"]],
+	displayMath: [["\\[", "\\]"]],
+	processEscapes: true,
+	processEnvironments: true
+    },
+    options: {
+	ignoreHtmlClass: ".*|",
+	processHtmlClass: "arithmatex"
+    }
+};

docs/use_case.md

@@ -1,5 +1,10 @@
 # Use Cases
 
+## DRAFT: Work in progress
+
+This material is a work in progress, at "rough draft" stage.
+
+
 ## Data Context
 
 ["data context"]( http://cidrdb.org/cidr2017/papers/p111-hellerstein-cidr17.pdf) –