docs(openapi): add descriptions to OpenAPI specification (#25185)

* faces

* add openapi descriptions

* remove dto descriptions

* gen openapi

* dtos

* fix dtos

* fix more

* fix build

* more

* complete dtos

* descriptions on rebase

* gen rebase

* revert correct integer type conversion

* gen after revert

* revert correct nullables

* regen after revert

* actually incorrect adding default here

* revert correct number type conversion

* regen after revert

* revert nullable usage

* regen fully

* readd some comments

* one more

* one more

* use enum

* add missing

* add missing controllers

* add missing dtos

* complete it

* more

* describe global key and slug

* add remaining body and param descriptions

* lint and format

* cleanup

* response and schema descriptions

* test patch according to suggestion

* revert added api response objects

* revert added api body objects

* revert added api param object

* revert added api query objects

* revert reorganized http code objects

* revert reorganize ApiOkResponse objects

* revert added api response objects (2)

* revert added api tag object

* revert added api schema objects

* migrate missing asset.dto.ts

* regenerate openapi builds

* delete generated mustache files

* remove descriptions from properties that are schemas

* lint

* revert nullable type changes

* revert int/num type changes

* remove explicit default

* readd comment

* lint

* pr fixes

* last bits and pieces

* lint and format

* chore: remove rejected patches

* fix: deleting asset from asset-viewer on search results (#25596)

* fix: escape handling in search asset viewer (#25621)

* fix: correctly show owner in album options modal (#25618)

* fix: validation issues

* fix: validation issues

---------

Co-authored-by: Jason Rasmussen <jason@rasm.me>
Co-authored-by: Min Idzelis <min123@gmail.com>
Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com>
Co-authored-by: Paul Makles <me@insrt.uk>

mobile/openapi/lib/model/sync_asset_v1.dart

@@ -34,42 +34,61 @@ class SyncAssetV1 {
     required this.width,
   });
 
+  /// Checksum
   String checksum;
 
+  /// Deleted at
   DateTime? deletedAt;
 
+  /// Duration
   String? duration;
 
+  /// File created at
   DateTime? fileCreatedAt;
 
+  /// File modified at
   DateTime? fileModifiedAt;
 
+  /// Asset height
   int? height;
 
+  /// Asset ID
   String id;
 
+  /// Is edited
   bool isEdited;
 
+  /// Is favorite
   bool isFavorite;
 
+  /// Library ID
   String? libraryId;
 
+  /// Live photo video ID
   String? livePhotoVideoId;
 
+  /// Local date time
   DateTime? localDateTime;
 
+  /// Original file name
   String originalFileName;
 
+  /// Owner ID
   String ownerId;
 
+  /// Stack ID
   String? stackId;
 
+  /// Thumbhash
   String? thumbhash;
 
+  /// Asset type
   AssetTypeEnum type;
 
+  /// Asset visibility
   AssetVisibility visibility;
 
+  /// Asset width
   int? width;
 
   @override