Merge branch '2411-check-copyright'

[arvados.git] / doc / api / storage.html.textile.liquid

diff --git a/doc/api/storage.html.textile.liquid b/doc/api/storage.html.textile.liquid
index 0baaef7b2a10264bb53a6b86d525dc48de91b4f0..c3ce2d6b675b7e44f7ce066835832ea68b396cf2 100644 (file)
--- a/doc/api/storage.html.textile.liquid
+++ b/doc/api/storage.html.textile.liquid
@@ -3,6 +3,11 @@ layout: default
 navsection: api
 title: Storage in Keep
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
+
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
 
 Keep clients are applications such as @arv-get@, @arv-put@ and @arv-mount@ which store and retrieve data from Keep.  In doing so, these programs interact with both the API server (which stores file metadata in form of Collection objects) and individual Keep servers (which store the actual data blocks).
 
@@ -23,10 +28,10 @@ h2. Storing a file
 h2. Fetching a file
 
 # The client requests a @collection@ object including @manifest_text@ from the APIs server
-# The server adds "token signatures" to the @manifest_text@, these signatures are used to prove to Keep servers that the client is permitted to read a given block
+# The server adds "token signatures" to the @manifest_text@ and returns it to the client.
 # The client discovers keep servers (or proxies) using the @accessible@ method on "keep_services":{{site.baseurl}}/api/methods/keep_services.html
 # For each data block, the client chooses the highest priority server using rendezvous hashing, described below.
-# The client sends the data block request to the keep server, including the token signature (proof of access).
+# The client sends the data block request to the keep server, along with the token signature from the API which proves to Keep servers that the client is permitted to read a given block.
 # The server provides the block data after validating the token signature for the block (if the server does not have the block, it returns a 404 and the client tries the next highest priority server)
 
 !{{site.baseurl}}/images/Keep_rendezvous_hashing.svg!