adapt packaging readmes

packaging/nominatim-db/README.md

@@ -1,5 +1,4 @@
-Nominatim - DB Backend
-=========
+# Nominatim - DB Backend
 
 Nominatim is a tool to search OpenStreetMap data
 by name and address (geocoding) and to generate synthetic addresses of
@@ -8,14 +7,45 @@ OSM points (reverse geocoding).
 This module implements the database backend for Nominatim and the
 command-line tool for importing and maintaining the database.
 
-Documentation
-=============
+## Installation
+
+### Prerequisites
+
+Nominatim requires [osm2pgsql](https://osm2pgsql.org/) (>=1.8) for reading
+OSM data and [PostgreSQL](https://www.postgresql.org/) to store the data.
+
+On Ubuntu (>=23.04) and Debian (using backports), you can install them with:
+
+    sudo apt-get install osm2pgsql postgresql-postgis
+
+### Installation from pypi
+
+To install Nominatim from pypi, run:
+
+    pip install nominatim-db
+
+
+## Quick start
+
+First create a project directory for your new Nominatim database, which
+is the space for additional configuration and customization:
+
+    mkdir planet-project
+
+Download an appropriate data extract, for example from
+[Geofabrik](https://download.geofabrik.de/) and import the file:
+
+    nominatim import --osm-file <downlaoded-osm-data.pbf>
+
+You will need to install the 'nominatim-api' package to query the
+database.
+
+## Documentation
 
 The documentation of the latest development version is in the
 `docs/` subdirectory. A HTML version can be found at
 https://nominatim.org/release-docs/develop/ .
 
-License
-=======
+## License
 
 The source code is available under a GPLv3 license.