Rewrite Abstract, introduction and title (#46)

Rewrite Abstract, introduction and title
Wimmics · Sep 19, 2024 · 91117e1 · 91117e1
1 parent 94a07ce
commit 91117e1
Showing 1 changed file with 16 additions and 37 deletions.
diff --git a/specs/solid-indexing/index.html b/specs/solid-indexing/index.html
@@ -3,7 +3,7 @@
 
 <head>
   <meta charset="utf-8" />
-  <title>Indexing Ontology</title>
+  <title>Shape-based indexing RDF vocabulary</title>
   <script src="https://www.w3.org/Tools/respec/respec-w3c" class="remove" defer></script>
   <script class="remove">
     // All config options at https://respec.org/docs/
@@ -20,8 +20,7 @@
 
 <body>
   <section id="abstract">
-    <p>This document describes a vocabulary and some techniques to index and find linked RDF data on the Web. TODO: à
-      qui s'adresse ce document ?</p>
+    <p>This document proposes an RDF vocabulary to describe indexes which are intended to be published on the Web,  to facilitate the search of data by Semantic Web agents. Some indexing and index-querying techniques are also introduced.</p>
   </section>
 
   <section id="sotd">
@@ -32,43 +31,13 @@
   <section class="informative">
     <h2>Introduction</h2>
 
-    <p>The Web is made of documents like web pages, API data, images and so on that are linked together. They are
-      information that anyone with the proper authorization can access. Documents can be found everywhere
-      on the web and we often have to follow the links between them in order to find relevant information. The
-      web is therefore browsable but browsing it manually can be very long to find what we are searching for.
-      That's why search engines have been invented. They browse the web for us by following the
-      links, they find in documents so they can tell us where to get documents about a particular subject.
-    </p>
+    <p>The Semantic Web vision consists in publishing on the Web machine-readable documents so that machine, like humans, become able to browse the Web, following links from one document to another, in order to gather information and answer complex questions.</p>
 
-    <p>Search engines are doing indexing. Indexing is a largely used mechanism that allow to find data faster thanks to
-      [=indexes=]. By querying
-      the appropriate indexes one can avoid to search at unuseful places. Indexing is also widely used in all kind of software, especially in databases. On the traditionnal web, search engines are indexing  
-      documents globally so even if we saved time we still have to look at the content of the documents by ourselves to see 
-      if the thing we are searching for is there.
-    </p>
+    <p>Hovewer, when a lot of data is available, gathering information and answering complex questions becomes very ineffiscient without indexes. Indexes are made of meta-data that allow to find data more easily and more quickly. Indexing is a widely used mechanism in all kind of software, especially in databases.</p>
 
-    <p>There is an other Web, the semantic Web, sometimes called the Web of data or the Web 3.0. It works the same as the 
-      traditionnal Web except that information is described to machines so they can "understand" what documents and the 
-      things they contain are about. This way we can directly get the information we need without having to look at the 
-      content of documents. This is made possible thanks to the Resource Description Framework (RDF). On this improved Web, 
-      knowledge can be deduced automatically by machines. For instance, if a document is about a person and the machines 
-      know that a person is a human, they can deduce that this person is a human. Search engines can benefit a lot from the web 
-      of data and some engines already take advantage of it to better respond to our queries.
-    </p>
+    <p>This document proposes an RDF vocabulary to describe one kind of such indexes, which are also intended to be published on the Web, to facilitate the search of data by Semantic Web agents. In addition, this document also presents some indexing and index-querying techniques.</p>
 
-    <p>
-      In this document we introduce a reusable RDF vocabulary and techniques to index semantic data. A reusable vocabulary 
-      is great to facilitate interoperability and we hope that you will find it suited to your needs. Even if there is no 
-      search field in your application, search operation are often trigerred for instance when some data is displayed. 
-      Indexing you data should improve the performances of your application. Indexing is also useful to make your data 
-      discoverable.
-    </p>
-
-    <ul>
-      <li>indexer des données privées ?</li>
-      <li>Mettre les pattern à une lettre dans un index. Exemple straight + section optimisation.</li>
-      <li>Parler des différents types d'indexation, single, multiple, fédéré, distribué...</li>
-    </ul>
+    <p>This need for a standard indexing vocabulary appeared in the context of the Solid protocol where several applications interact in the same way with the same data to achieve interoperability. Indeed, as the data is decoupled from the applications, these applications must agree on a client-to-client protocol to work together. If they want to be able to use the same indexes, these must be standardized.</p>
 
     <section>
       <h3>Terminology</h3>
@@ -118,6 +87,11 @@ <h3>Namespaces</h3>
     </section>
   </section>
 
+  <section>
+    <h2>Vocabulary</h2>
+
+  </section>
+
   <section>
     <h2>Indexes</h2>
 
@@ -295,6 +269,11 @@ <h3>Relation to Solid Type indexes</h3>
 
       <p>Solid Type Indexes are designed to...</p>
     </section>
+
+    <section>
+      <h3>Indexing private data?</h3>
+    </section>
+
   </section>
 
   <section id="conformance">