regenerated all docs

Makefile

@@ -13,7 +13,7 @@ SOURCE_SCHEMA_PATH = $(shell sh ./utils/get-value.sh source_schema_path)
 SRC = .
 DEST = target
 PYMODEL = linkml_model/
-DOCDIR = stage/docs
+DOCDIR = $(DEST)/docs
 
 # basename of a YAML file in model/
 .PHONY: all clean

README.md

@@ -5,18 +5,39 @@
 
 
 # LinkML Model
-Basic model and documentation for the Linked Open Data Modeling Language (LinkML)
 
-# [Model Documentation](https://linkml.github.io/linkml-model/docs)
+Metamodel schema, documentation, and specification for the Linked Open Data Modeling Language (LinkML)
 
-# For Developers
+This documentation is best viewed view the generated web documentation
 
-## Installation
+- [https://w3id.org/linkml/](https://linkml.github.io/linkml-model/docs)
 
-This project uses [pipenv](https://pipenv-fork.readthedocs.io/en/latest/) for installation. Some IDE's like PyCharm also have direct [support](https://www.jetbrains.com/help/pycharm/pipenv.html) for pipenv.
+## Quick Links
+
+- [Generated documentation](https://linkml.github.io/linkml-model/docs)
+- [Specification](https://linkml.io/linkml-model/docs/specification/00preamble/)
+- [Source YAML for metamodel](https://github.com/linkml/linkml-model/tree/main/linkml_model/model/schema)
+- [Main LinkML site](https://linkml.io)
+
+## About LinkML
+
+LinkML is a modeling framework for building datamodels and related applications.
+
+The best place to start discovering more about linkml is on the main LinkML website, [linkml.io/linkml](https://linkml.io/linkml)
+
+LinkML is self-describing, and the underlying datamodel for describing data models is in LinkML. This repository contains that data model
+
+## For Developers
+
+See the [contributing docs](https://linkml.io/linkml/contributing/contributing.html)
+
+### Installation
+
+This project uses poetry:
 
 ```bash
-> pipenv install linkml-model
+> cd linkml-model
+> poetry install
 ```
 
 ## Running tests