From 89c63a44572d7261e6f5b2a3fa0e563c27efea4b Mon Sep 17 00:00:00 2001
From: Ricky <ricky@drave.dev>
Date: Sun, 21 Mar 2021 20:13:29 +0000
Subject: [PATCH] fix SOLID doc
---
.../Solid-introduction.rst | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/source/import_documentation/Solid-introduction.rst b/source/import_documentation/Solid-introduction.rst
index b9f223a..36a63f5 100644
--- a/source/import_documentation/Solid-introduction.rst
+++ b/source/import_documentation/Solid-introduction.rst
@@ -4,17 +4,17 @@ Our SOLID introduction
in the 3WC by `Tim Berners Lee <https://fr.wikipedia.org/wiki/Tim_Berners-Lee>`__, the inventor of
the web who aims to rethink the way we build application in order to give back the power back to the final user.
-For us SOLID project is above all a philosophy, a goal to reach and which inspires us.
+For us SOLID project is above all a philosophy, a goal to reach and that inspires us.
Solid is built on top of existing Web standards. The core Solid specification relies on LDP and WAC (WAC draft, both being based on HTTP and RDF vocabularies. Solid also uses a subset of SPARQL UPDATE through HTTP PATCH queries. Identification in Solid is based on WebID-TLS and/or OIDC.
-To know more on how does Solid relate to other Web standards, how a look to this `SOLID Faq <https://solidproject.org/faqs#how-does-solid-relate-to-other-web-standards>`__.
+To know more on how does Solid relate to other Web standards, have a look to this `SOLID Faq <https://solidproject.org/faqs#how-does-solid-relate-to-other-web-standards>`__.
Let's have an overview on how we implement `SOLID specifications <https://github.com/solid/solid-spec>`__.
What is SOLID ?
---------------
-It is a set of standards on which we agree internationally to communicate our applications between them. It is about the standardization of APIs.
+It is a set of standards on which we agree internationally to enable our applications to communicate with each other. It is about the standardization of APIs.
.. warning::
@@ -96,14 +96,14 @@ Did you notice the presence of a context ?
It is a way to go from the Json to `JsonLD <https://fr.wikipedia.org/wiki/JSON-LD>`__
That’s mean that we encode `Linked
-Data <https://en.wikipedia.org/wiki/Linked_data>`__ using Json.
+Data <https://en.wikipedia.org/wiki/Linked_data>`__ using JSON.
JsonLD is an `RDF <https://en.wikipedia.org/wiki/RDF>`__ implementation,
-which is its-selft the basic language of `semantic
+which is itself the basic language of `semantic
web <https://en.wikipedia.org/wiki/Semantic_Web>`__.
.. warning::
- We use for our API JsonLD but you can imagine use other implementation like Turtle or XML.
+ We use for our API JsonLD but you can imagine using other implementations like Turtle or XML.
This context allows you to link object properties in a JSON document to
concepts in an `ontology <https://en.wikipedia.org/wiki/Web_Ontology_Language>`__.
@@ -139,7 +139,7 @@ Here is the context referred :
}
The type we use is ``foaf``. That means that we use the FOAF ontology
-which is done to describe people.
+which is designed to describe people.
If you go to the `foaf ontology <http://xmlns.com/foaf/0.1/>`__, you’ll
see that the properties which we can use are :
@@ -157,7 +157,7 @@ status \| surname \| theme \| thumbnail \| tipjar \| title \| topic \|
topic_interest \| weblog \| workInfoHomepage \| workplaceHomepage \|
yahooChatID \|
-Now we can describe a user for every machines in the world using a
+Now we can describe a user for every machine in the world using a
universal language :)
Why JsonLD is awesome ?
@@ -182,7 +182,7 @@ JsonLD allow us to us Linked Datas in a very intuitive way.
Let's speak about containers
----------------------------
-So how JsonLD manage to tiny the datas ?
+So how JsonLD manage to simplify the datas ?
Let’s have a look on this part :
--
GitLab