Add notes

Author: jason-fox

README.ja.md

@@ -235,7 +235,7 @@ NGSI-LD サブスクリプション・リクエストの `type` は常に `type=
 Context Broker 自体への GET リクエストと同じように機能します。フラグが設定されていない場合、デフォルトで `@context`
 を含む完全な NGSI-LD レスポンスが返され、さらに制限を追加することでペイロードを削減および修正できます。
 
-#### :one: リクエスト:
+#### 1️⃣ リクエスト:
 
 ```console
 curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
@@ -266,7 +266,7 @@ curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
 します。`notification.format=normalized` および `notification.endpoint.accept=application/ld+json` は、通知リクエストの
 ボディで `@context` が渡され、ペイロードが展開されたエンティティで構成されることを保証します。
 
-#### :two: リクエスト:
+#### 2️⃣ リクエスト:
 
 ```console
 curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
@@ -297,7 +297,7 @@ curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
 サブスクリプション CRUD アクションは、以前と同じ HTTP 動詞に引き続きマップされます。`Accept:application/json` を追加
 すると、レスポンスボディから`@context` 要素が削除されます。
 
-#### :three: リクエスト:
+#### 3️⃣ リクエスト:
 
 ```console
 curl -L -X GET 'http://localhost:1026/ngsi-ld/v1/subscriptions/'
@@ -468,7 +468,7 @@ Context Broker A にレジストレーションする循環依存関係を回避
 -   NGSI-v2 属性は、`properties` と `relationships` の個別の配列に分割されました
 -   NGSI-v2 `provider.url`が `endpoint` に移動しました
 
-#### :four: リクエスト:
+#### 4️⃣ リクエスト:
 
 ```console
 curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
@@ -505,7 +505,7 @@ curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
 レジストレーションの詳細を取得するには、GETリクエストを `/ngsi-ld/v1/csourceRegistrations/` エンドポイントに送信し、
 `Link` ヘッダの適切な JSON-LD コンテキストとフィルタリングするエンティティの `type` を指定します。
 
-#### :five: リクエスト:
+#### 5️⃣ リクエスト:
 
 ```console
 curl -G -iX GET 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
@@ -552,7 +552,7 @@ curl -G -iX GET 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
 レジストレーションされたエンドポイントにプロキシされます。部分的なレジストレーションの場合、プロパティと
 レジストレーションは Context Broker 内に保持されている既存のエンティティに追加されます。
 
-#### :six: リクエスト:
+#### 6️⃣ リクエスト:
 
 ```console
 curl -iX GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001' \
@@ -650,7 +650,7 @@ curl -iX GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:sto
 
 レジストレーションされた属性を照会するときに、同じリクエストが Context Broker 自体によって行われます。
 
-#### :seven: リクエスト:
+#### 7️⃣  リクエスト:
 
 ```console
 curl -L -X GET 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001?attrs=tweets' \
@@ -688,7 +688,7 @@ curl -L -X GET 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi
 読み取り/書き込みインターフェースの場合、関連する `ngsi-ld/v1/entities/<entity-id>/attrs` エンドポイントに PATCH
 リクエストを行うことで、コンテキスト・データを修正することもできます。
 
-#### :eight: リクエスト:
+#### 8️⃣  リクエスト:
 
 ```console
 curl -L -X PATCH 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001/attrs' \
@@ -706,7 +706,7 @@ curl -L -X PATCH 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ng
 }'
 ```
 
-#### :nine: リクエスト:
+#### 9️⃣ リクエスト:
 
 レジストレーションされた属性が Context Broker からリクエストされた場合、
 `http://tutorial:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001`
@@ -746,7 +746,7 @@ curl -L -X GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:s
 
 ### フォワード更新 (Forwarded-update)
 
-#### :one::zero: リクエスト:
+#### 1️⃣0️⃣ リクエスト:
 
 Context Broker への PATCH リクエスト (`ngsi-ld/v1/entities/<entity-id>/` または
 `ngsi-ld/v1/entities/<entity-id>/attrs`) は、レジストレーションが見つかった場合、レジストレーションされたコンテキスト
@@ -771,7 +771,7 @@ curl -L -X PATCH 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building
 } '
 ```
 
-#### :one::one: リクエスト:
+#### 1️⃣1️⃣ リクエスト:
 
 前の操作の結果は、GET リクエストを使用してエンティティ全体を取得することで確認できます。
 

README.md

@@ -218,7 +218,7 @@ lost, it is merely passed as a `Link` header. In summary, all of the flags withi
 as a GET request to the context broker itself. If no flags are set, a full NGSI-LD response including the `@context` is
 returned by default, and the payload can be reduced and amended by adding in further restrictions.
 
-#### :one: Request:
+#### 1️⃣ Request:
 
 ```console
 curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
@@ -248,7 +248,7 @@ This second request fires notifications to a different endpoint (URL
 `notification.endpoint.accept=application/ld+json` will ensure that the `@context` is passed in the body of the
 notification request and that the payload will consist of the expanded entities.
 
-#### :two: Request:
+#### 2️⃣ Request:
 
 ```console
 curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/subscriptions/' \
@@ -277,7 +277,7 @@ Subscription details can be read by making a GET request to the `/ngsi-ld/v1/sub
 actions continue to be mapped to the same HTTP verbs as before. Adding the `Accept: application/json` will remove the
 `@context` element from the response body.
 
-#### :three: Request:
+#### 3️⃣ Request:
 
 ```console
 curl -L -X GET 'http://localhost:1026/ngsi-ld/v1/subscriptions/'
@@ -481,7 +481,7 @@ The body of the request is similar to the **NGSI-v2** equivalent with the follow
 special key which fires a JSON-LD expansion/compaction operation to ensure that the attribute names within the request
 match the expected **NGSI-v2** attribute names.
 
-#### :four: Request:
+#### 4️⃣ Request:
 
 ```console
 curl -iX POST 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
@@ -525,7 +525,7 @@ curl -iX POST 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
 Retrieving the registration details can be made by sending a GET request to the `/ngsi-ld/v1/csourceRegistrations/`
 endpoint, along with an appropriate JSON-LD context in the `Link` header and the `type` of entity to filter
 
-#### :five: Request:
+#### 5️⃣ Request:
 
 ```console
 curl -G -iX GET 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
@@ -580,7 +580,7 @@ returned when an requested entity is requested. For simple registrations, a requ
 proxied to the registered `endpoint`, for partial registrations the `properties` and `relationships` are added to the
 existing entity held within the context broker.
 
-#### :six: Request:
+#### 6️⃣ Request:
 
 ```console
 curl -iX GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001' \
@@ -677,7 +677,7 @@ in this case a request is merely returning the full `tweets` attribute.
 
 The same request is made by the context broker itself when querying for registered attributes
 
-#### :seven: Request:
+#### 7️⃣  Request:
 
 ```console
 curl -L -X GET 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001?attrs=tweets' \
@@ -715,7 +715,7 @@ the response resembles any standard NGSI-LD request.
 For a read-write interface it is also possible to amend context data by making a PATCH request to the relevant
 `ngsi-ld/v1/entities/<entity-id>/attrs` endpoint.
 
-#### :eight: Request:
+#### 8️⃣  Request:
 
 ```console
 curl -L -X PATCH 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001/attrs' \
@@ -733,7 +733,7 @@ curl -L -X PATCH 'http://localhost:3000/static/tweets/ngsi-ld/v1/entities/urn:ng
 }'
 ```
 
-#### :nine: Request:
+#### 9️⃣ Request:
 
 If the regisitered attribute is requested from the context broker, it returns the _updated_ values obtained from
 `http://tutorial:3000/static/tweets/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001` - i.e. the forwarding endpoint.
@@ -771,7 +771,7 @@ The context broker is therefore able to return a complete holistic picture of th
 
 ### Forwarded Update
 
-#### :one::zero: Request:
+#### 1️⃣0️⃣ Request:
 
 A PATCH request to the context broker ( either `ngsi-ld/v1/entities/<entity-id>/` or
 `ngsi-ld/v1/entities/<entity-id>/attrs`) will be forwarded to the registered context provider if a registration is
@@ -795,7 +795,7 @@ curl -L -X PATCH 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building
 } '
 ```
 
-#### :one::one: Request:
+#### 1️⃣1️⃣ Request:
 
 The result of the previous operation can be seen by retrieving the whole entity using a GET request.