update documentation and vocabulary SQL files

extensions/vocabulary-api/README.md

@@ -0,0 +1,19 @@
+# Vocabulary API
+
+Provides a management API for work with vocabularies. This API expands the functionality of the control-plane management API to be able to handle Vocabulary entities.
+
+
+## Vocabulary entity
+
+An example of a Vocabulary entity is shown below.
+
+```
+{
+  "@context": {
+    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
+  },
+  "@id": "vocabularyId",
+  "name": "Vocabulary name",
+  "jsonSchema": "{ \"title\": \"vocabulary\", \"type\": \"object\", \"properties\": { \"name\": { \"type\": \"string\", \"title\": \"Name\" }, \"keyword\": { \"type\": \"array\", \"title\": \"Keywords\", \"items\": { \"type\": \"string\" } } }, \"required\": [ \"name\" ] }"
+}
+```

extensions/vocabulary-index-sql/docs/schema.sql

@@ -1,10 +1,10 @@
 -- table: edc_vocabulary
 CREATE TABLE IF NOT EXISTS edc_vocabulary
 (
-    id           VARCHAR NOT NULL,
+    id                 VARCHAR NOT NULL,
     created_at         BIGINT  NOT NULL,
     json_schema        JSON    DEFAULT '{}',
-    vocabulary_name    VARCHAR NOT NULL,
+    name               VARCHAR NOT NULL,
     PRIMARY KEY (id)
 );
 

extensions/vocabulary-index-sql/src/main/java/org/upm/inesdata/vocabulary/sql/index/schema/VocabularyStatements.java

@@ -71,7 +71,7 @@ default String getCreatedAtColumn() {
     /**
      * Generates a SQL query using sub-select statements out of the query spec.
      *
-     * @param query query to be executed
+     * @param query querySpec to be executed
      * @return A {@link SqlQueryStatement} that contains the SQL and statement parameters
      */
     SqlQueryStatement createQuery(QuerySpec query);

resources/sql/vocabulary-schema.sql

@@ -1,10 +1,10 @@
 -- table: edc_vocabulary
 CREATE TABLE IF NOT EXISTS edc_vocabulary
 (
-    id           VARCHAR NOT NULL,
+    id                 VARCHAR NOT NULL,
     created_at         BIGINT  NOT NULL,
     json_schema        JSON    DEFAULT '{}',
-    vocabulary_name    VARCHAR NOT NULL,
+    name               VARCHAR NOT NULL,
     PRIMARY KEY (id)
 );