Fix subscription documentation

Author: Sporiff

src/docs/subscriptions.adoc

@@ -3,7 +3,7 @@
 :sectlinks:
 
 The `subscriptions` endpoint exposes operations taken on subscriptions.
-A subscriptionEntity represents two things:
+A subscription represents two things:
 
 1. A podcast feed
 2. The relationship between a user and a podcast feed
@@ -16,8 +16,8 @@ POST /api/v1/users
 [[actions-subscriptions-create]]
 == Create subscriptions
 
-When a user adds a subscription to the system, a corresponding `subscriptionEntity` object is fetched or created depending on whether a matching subscriptionEntity is present.
-A link is then created between the user and the subscriptionEntity.
+When a user adds a subscription to the system, a corresponding `subscription` object is fetched or created depending on whether a matching subscription is present.
+A link is then created between the user and the subscription.
 
 operation::subscriptions-bulk-create-mixed[snippets='request-headers,request-fields,curl-request,response-fields,http-response']
 
@@ -38,28 +38,27 @@ include::{snippets}/subscriptions-bulk-create-mixed/http-response.adoc[]
 [[actions-subscriptions-list]]
 == List subscriptions
 
-When a user fetches a list of subscriptions, their own subscriptions are returned.
-The subscriptions of other users are not returned.
+When a user fetches a list of subscriptions, only their own subscriptions are returned.
 
 operation::subscriptions-list[snippets='request-headers,query-parameters,curl-request,response-fields,http-response']
 
 === Include unsubscribed
 
 operation::subscriptions-list-with-unsubscribed[snippets='curl-request,http-response']
 
-[[actions-subscriptionEntity-fetch]]
-== Fetch a single subscriptionEntity
+[[actions-subscription-fetch]]
+== Fetch a single subscription
 
-Returns the details of a single subscriptionEntity for the authenticated user.
-Returns `404` if the user has no subscriptionEntity entry for the feed in question.
+Returns the details of a single subscription for the authenticated user.
+Returns `404` if the user has no subscription entry for the feed in question.
 
 operation::subscription-get[snippets='request-headers,path-parameters,curl-request,response-fields,http-response']
 
-[[actions-subscriptionEntity-update]]
+[[actions-subscription-update]]
 == Unsubscribe from a feed
 
 Unsubscribes the authenticated user from a feed.
-This action updates the user subscriptionEntity record to mark the subscriptionEntity as inactive.
-It does not delete the subscriptionEntity record.
+This action updates the user subscription record to mark the subscription as inactive.
+It does not delete the subscription record.
 
 operation::subscription-unsubscribe[snippets='request-headers,path-parameters,curl-request,response-fields,http-response']