diff --git a/README.rst b/README.rst index b562d13..a62c605 100644 --- a/README.rst +++ b/README.rst @@ -30,32 +30,25 @@ Library prototyping based on Calibre ------------------------------------ Calibrestekje is a Python library which provides a way to work with the -`Calibre`_ metadata database outside the context of the Calibre desktop and web +`Calibre`_ database outside the context of the Calibre desktop and web interfaces. A set of generated `SQLAlchemy`_ bindings (see `sqlacodegen`_ for -more) are provided which allow for the querying of an existing Calibre metadata -database (a file typically called ``metadata.db``). These bindings are more -fine grained than Calibres `database interface`_ and provide access to the -Database table layer. - -The idea of a "stekje" (Dutch word meaning "little graft") in the context of -software came out of the discussions at `Relearn`_ around cutting, grafting, -remixing, re-using and misusing software for collective work. - -This stekje can be understood as a low level building block for experimenting -with new ways of doing library software. One exciting part about a stekje is -that it is possible that new roots will appear. It is hoped that Calibrestekje -may help new library software take root. +more) are provided which allow for the read/write access to an existing Calibre +metadata database (a file typically called ``metadata.db``). These bindings are +more fine grained than Calibres `database interface`_ and provide direct access +to the Database table layer. .. _Calibre: https://calibre-ebook.com/ .. _SQLALchemy: https://docs.sqlalchemy.org/ .. _sqlacodegen: https://github.com/agronholm/sqlacodegen .. _database interface: https://manual.calibre-ebook.com/db_api.html -.. _Relearn: http://relearn.be/2019/ +.. _Relearn!: http://relearn.be/2019/ .. _example: -Example -******* +Quick Example +************* + +See documentation linked below for more. .. code-block:: python