[COMP-673] Add description and runtime version (#26)

* Add description and runtime version

* Updated build queue

Author: blueberry-pi

.buildkite/premerge.steps.yaml

@@ -14,7 +14,7 @@ common: &common
     # TODO(EV): Make docs better. (https://github.com/improbable/platform/blob/master/docs/product-groups/dev-workflow/buildkite/how-to-deploy-change-to-agents.md)
     - "capable_of_building=platform"
     - "environment=production"
-    - "queue=v-ccadbedf01b84f29-------1540485662"
+    - "queue=v2-1545678177-378924f50bfed5a0-------z"
   timeout_in_minutes: 60 # TODO(ENG-548): reduce timeout once agent-cold-start is optimised.
   retry:
     automatic:

WORKSPACE

@@ -61,8 +61,8 @@ git_repository(
 git_repository(
     name = "improbable_platform",
     remote = "git@github.com:improbable/platform.git",
-    commit = "246c6a1db4e352b51f4d2197cdf600077ab41bce",
-    shallow_since = "2018-12-01",
+    commit = "777672f36dbc103621ee04dec1786da2cdd48599",
+    shallow_since = "2019-02-01",
 )
 
 new_git_repository(

apis/deployment_v1alpha1/Deployment.cs

@@ -514,7 +514,9 @@ public string DeploymentName {
     public const int PageSizeFieldNumber = 3;
     private int pageSize_;
     /// <summary>
-    /// The number of snapshots to provide in each page of the paginated results.
+    /// Optional. The number of snapshots to fetch in each page of the paginated results.
+    /// If provided, the `page_size` must be a positive integer. If omitted,
+    /// the default value of 20 is used.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public int PageSize {
@@ -528,8 +530,7 @@ public int PageSize {
     public const int PageTokenFieldNumber = 4;
     private string pageToken_ = "";
     /// <summary>
-    /// A token, previously provided by the service as a `next_page_token`, for retrieving additional
-    /// pages of paginated results.
+    /// Optional. An opaque token to identify the start of the paginated results.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public string PageToken {
@@ -699,6 +700,9 @@ public ListSnapshotsResponse Clone() {
     private static readonly pb::FieldCodec<global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot> _repeated_snapshot_codec
         = pb::FieldCodec.ForMessage(10, global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot.Parser);
     private readonly pbc::RepeatedField<global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot> snapshot_ = new pbc::RepeatedField<global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot>();
+    /// <summary>
+    /// By default, snapshots are sorted by creation time (descending).
+    /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public pbc::RepeatedField<global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot> Snapshot {
       get { return snapshot_; }
@@ -872,7 +876,7 @@ public string DeploymentName {
     public const int IdFieldNumber = 3;
     private string id_ = "";
     /// <summary>
-    /// The identifier for the desired snapshot.
+    /// The identifier for the snapshot.
     /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public string Id {
@@ -1146,6 +1150,16 @@ public TakeSnapshotRequest Clone() {
     /// <summary>Field number for the "snapshot" field.</summary>
     public const int SnapshotFieldNumber = 1;
     private global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot snapshot_;
+    /// <summary>
+    /// These fields are mandatory:
+    /// - `project_name`
+    /// - `deployment_name`
+    ///
+    /// These fields are optional:
+    /// - `tags`
+    ///
+    /// Other set values will be ignored.
+    /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot Snapshot {
       get { return snapshot_; }
@@ -1358,6 +1372,17 @@ public UploadSnapshotRequest Clone() {
     /// <summary>Field number for the "snapshot" field.</summary>
     public const int SnapshotFieldNumber = 1;
     private global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot snapshot_;
+    /// <summary>
+    /// These fields are mandatory:
+    /// - `project_name`
+    /// - `deployment_name`
+    /// - `checksum`
+    ///
+    /// These fields are optional:
+    /// - `tags`
+    ///
+    /// Other set values will be ignored.
+    /// </summary>
     [global::System.Diagnostics.DebuggerNonUserCodeAttribute]
     public global::Improbable.SpatialOS.Snapshot.V1Alpha1.Snapshot Snapshot {
       get { return snapshot_; }