tmp

docs/FAQ.md

@@ -31,29 +31,6 @@
 **🛠 Work in progress 🛠**
 -->
 
-### How can I visualize the schema for a `protocol` or an `activity`?
-
-If you want to see what the assessment that are already supported by the ReproSchema would look like using our ReproSchema user-interface, you can visualize them directly on [schema.repronim.org](https://schema.repronim.org/rl).
-
-If you just want to view a protocol or activity you are developing using the `reproschema-ui`,
-you can pass the URL of the schema to the `url` query parameter like this:
-
-```https://schema.repronim.org/ui/#/?url=url-to-your-schema```
-
-If you are hosting a schema on github, make sure that you are passing the URL of the **raw** content of the schema.
-For example, our demo protocol can be accessed at this URL:
-
-[https://github.com/ReproNim/reproschema-demo-protocol/blob/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema](https://github.com/ReproNim/reproschema-demo-protocol/blob/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema)
-
-But to get access to the raw content of that file you must click on the `Raw` button
-once you have opened that page on github that will open this URL:
-
-[https://raw.githubusercontent.com/ReproNim/reproschema-demo-protocol/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema](https://raw.githubusercontent.com/ReproNim/reproschema-demo-protocol/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema).
-
-If you want to visualize the graph represented by the JSON-LD file,
-we explain how to do this in [From JSON to JSON-LD](#from-json-to-json-ld).
-
-
 ### Which assessments tools will/are supporting this standard?
 
 At the moment, all the assessments that support this standard are listed in [this folder](https://github.com/ReproNim/reproschema-library/tree/master/activities) or the [reproschema-library repository](https://github.com/ReproNim/reproschema-library).

docs/how-to/validation.md

@@ -23,9 +23,9 @@ reproschema --log-level DEBUG validate PATH_TO_VALIDATE
 ### Automating validation
 
 If you are hosting your schema on a github repository,
-you can automate the validation with a with GitHub CI workflow.
+you can automate its validation with a with GitHub CI workflow.
 
-For example if you repository is structured like this:
+For example if your repository is structured like this:
 
 ```text
 ├── protocols

docs/how-to/visualize.md

@@ -0,0 +1,24 @@
+# Visualize
+
+If you want to visualize the protocol or the activity you have created,
+you can use the [reproschema-ui](https://github.com/ReproNim/reproschema-ui) to preview it.
+
+If you want to see what the assessment that are already supported by the ReproSchema would look like using our ReproSchema user-interface, you can visualize them directly on [schema.repronim.org](https://schema.repronim.org/rl).
+
+If you just want to view a protocol or activity you are developing using the `reproschema-ui`,
+you can pass the URL of the schema to the `url` query parameter like this:
+
+```https://schema.repronim.org/ui/#/?url=url-to-your-schema```
+
+If you are hosting a schema on github, make sure that you are passing the URL of the **raw** content of the schema.
+For example, our demo protocol can be accessed at this URL:
+
+[https://github.com/ReproNim/reproschema-demo-protocol/blob/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema](https://github.com/ReproNim/reproschema-demo-protocol/blob/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema)
+
+But to get access to the raw content of that file you must click on the `Raw` button
+once you have opened that page on github that will open this URL:
+
+[https://raw.githubusercontent.com/ReproNim/reproschema-demo-protocol/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema](https://raw.githubusercontent.com/ReproNim/reproschema-demo-protocol/7ed1ae49279f75acdd57380fff1f8aaff2c7b511/reproschema_demo_protocol/reproschema_demo_protocol_schema).
+
+If you want to visualize the graph represented by the JSON-LD file,
+we explain how to do this in [From JSON to JSON-LD](#from-json-to-json-ld).