docs: improve bookmarks migration script docs

Author: maxceem

config/development.json

@@ -1,5 +1,4 @@
 {
-  "enableFileUpload": "false",
   "pubsubQueueName": "dev.project.service",
   "pubsubExchangeName": "dev.projects",
   "attachmentsS3Bucket": "topcoder-dev-media",

migrations/bookmarks/README.md

@@ -1,35 +1,19 @@
 # Migration script for Bookmarks
 
-To check the bookmarks migration, follow the instructions below:
+To run any of these commands, make sure that `NODE_ENV` environment variable is set to `production` or `development` depend on which environment you would like to run migration for.
 
-```bash
--- sync the database (This will drop and re-create the tables)
-NODE_ENV=development npm run sync:db
--- Insert the test data
-NODE_ENV=development npx babel-node migrations/bookmarks/insertTestData.js
-```
-
--- Check the database tables projects and project_attachments using the following SQL statements:
+## Migrate the bookmarks to project attachments
 
-```sql
-select id, name, bookmarks from projects order by id;
-select * from project_attachments;
-```
-
--- Migrate the bookmarks to project attachments
 ```bash
-NODE_ENV=development npm run migrate:bookmarks
+npm run migrate:bookmarks
 ```
 
--- Re-check the database usig the SQL statements above
+## Revert: migrate project attachments to the bookmarks
 
--- Revert the migration using the following command :
 ```bash
-NODE_ENV=development npm run migrate:bookmarks:revert
+npm run migrate:bookmarks:revert
 ```
 
--- Re-check the database using the following SQL statements:
-```sql
-select id, name, bookmarks from projects order by id;
-select id, pa.type, pa."deletedAt" from project_attachments pa
-```
+## References
+
+- [Verification guide for "Migration script for Bookmarks"](Verification.md)

migrations/bookmarks/Verification.md

@@ -0,0 +1,35 @@
+# Verification guide for "Migration script for Bookmarks"
+
+To check the bookmarks migration, follow the instructions below:
+
+```bash
+-- sync the database (This will drop and re-create the tables)
+NODE_ENV=development npm run sync:db
+-- Insert the test data
+NODE_ENV=development npx babel-node migrations/bookmarks/insertTestData.js
+```
+
+-- Check the database tables projects and project_attachments using the following SQL statements:
+
+```sql
+select id, name, bookmarks from projects order by id;
+select * from project_attachments;
+```
+
+-- Migrate the bookmarks to project attachments
+```bash
+NODE_ENV=development npm run migrate:bookmarks
+```
+
+-- Re-check the database usig the SQL statements above
+
+-- Revert the migration using the following command :
+```bash
+NODE_ENV=development npm run migrate:bookmarks:revert
+```
+
+-- Re-check the database using the following SQL statements:
+```sql
+select id, name, bookmarks from projects order by id;
+select id, pa.type, pa."deletedAt" from project_attachments pa
+```