From f2607c991ed530d9fe8bba057806cbcb5c464767 Mon Sep 17 00:00:00 2001
From: "raphael.wcosta@gmail.com" <raphael.wcosta@gmail.com>
Date: Thu, 1 Sep 2022 13:28:36 -0300
Subject: [PATCH] :bookmark: Prepare to release 1.0.0-alpha2

---
 CHANGES.rst            |  9 ++++++++-
 RUNNING.rst            | 23 ++++++++++++++++++++++-
 bdc_catalog/version.py |  2 +-
 3 files changed, 31 insertions(+), 3 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index b7d6ee2..b82f43c 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -11,8 +11,15 @@ Changes
 =======
 
 
+Version 1.0.0-alpha2 (2022-09-01)
+---------------------------------
+
+- Fix documentation RUNNING.rst
+- Fix migration conflict with LCCS-DB instance `#169 <https://github.com/brazil-data-cube/bdc-catalog/issues/169>`_.
+
+
 Version 1.0.0-alpha1 (2022-07-21)
---------------------------
+---------------------------------
 
 - Add authorization control to items `#78 <https://github.com/brazil-data-cube/bdc-catalog/issues/78>`_.
 - Review JSONSchemas for collection metadata - instrument key `#68 <https://github.com/brazil-data-cube/bdc-catalog/issues/68>`_.
diff --git a/RUNNING.rst b/RUNNING.rst
index 0fae8b0..f820efa 100644
--- a/RUNNING.rst
+++ b/RUNNING.rst
@@ -1,6 +1,6 @@
 ..
     This file is part of BDC-Catalog.
-    Copyright (C) 2019-2020 INPE.
+    Copyright (C) 2019-2022 INPE.
 
     BDC-Catalog is free software; you can redistribute it and/or modify it
     under the terms of the MIT License; see LICENSE file for more details.
@@ -9,6 +9,27 @@
 Running BDC-Catalog in the Command Line
 =======================================
 
+The Brazil Data Cube Catalog system uses the `Alembic Environment <https://alembic.sqlalchemy.org/en/latest/>`_
+to upgrade/downgrade versions. If you would like to use it as experimental environments (dev only), you may consider to follow
+`Development Mode`.
+
+For production environment, we strongly recommend you to adopt alembic migration way to be able to support improvements.
+
+
+Development Mode
+----------------
+
+**This step is not recommended for production environments. It will not generate alembic migration tree.**
+
+For development purposes, we have prepared a command line `bdc-db db create-schema` to create all definitions for BDC-Catalog::
+
+        export SQLALCHEMY_DATABASE_URI="postgresql://postgres:password@localhost:5432/bdcdb"
+        bdc-db db init
+        bdc-db db create-namespaces
+        bdc-db db create-extension-postgis
+        lccs-db db create-extension-hstore
+        bdc-db db create-schema
+
 
 Creating database definition
 ----------------------------
diff --git a/bdc_catalog/version.py b/bdc_catalog/version.py
index 3386d13..d4f21d9 100644
--- a/bdc_catalog/version.py
+++ b/bdc_catalog/version.py
@@ -9,4 +9,4 @@
 """Version information for BDC-Catalog."""
 
 
-__version__ = '1.0.0-alpha1'
+__version__ = '1.0.0-alpha2'