@financial-times/cp-content-pipeline-schema 2.5.3 → 2.5.4

package/src/generated/index.ts

@@ -40,42 +40,70 @@ export type Scalars = {
 };
 
 export type Accessibility = {
+  /** An array of captions for the clip. */
   readonly captions?: Maybe<ReadonlyArray<Maybe<Caption>>>;
+  /** An abstract syntax tree of the transcript for the clip. */
   readonly transcript?: Maybe<RichText>;
 };
 
 export type AltStandfirst = {
+  /** An introductory paragraph of the article. */
   readonly promotionalStandfirst?: Maybe<Scalars['String']['output']>;
 };
 
 export type AltTitle = {
+  /** A promotional title of the article. */
   readonly promotionalTitle?: Maybe<Scalars['String']['output']>;
 };
 
 export type Article = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** The parent article, indicating this article is a part of a series or package. */
   readonly containedIn?: Maybe<Content>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -91,29 +119,53 @@ export type ArticleUrlArgs = {
 };
 
 export type Audio = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** An array of media objects containing the url, the duration, the filesize and the media type. */
   readonly media?: Maybe<ReadonlyArray<Maybe<Media>>>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -129,114 +181,198 @@ export type AudioUrlArgs = {
 };
 
 export type BasicTopper = Topper & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type BrandedTopper = Topper & TopperWithBrand & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type Caption = {
+  /** The media type of the caption eg. text/vtt. */
   readonly mediaType?: Maybe<Scalars['String']['output']>;
+  /** The url of the caption, eg. 'https://next-media-api.ft.com/clips/captions/32065513'. */
   readonly url?: Maybe<Scalars['String']['output']>;
 };
 
 export type Clip = {
+  /** An array of data sources - includes 'video/mp4' and 'audio/mp3' sources. */
   readonly dataSource: ReadonlyArray<ClipSource>;
+  /** The format of the clip, eg. 'standard-inline' or 'mobile'. */
   readonly format?: Maybe<Scalars['ClipFormat']['output']>;
+  /** The unique identifier of the clip - a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** The url of the image to be used as a poster for the clip, eg. 'https://www.ft.com/__origami/service/image...'. */
   readonly poster?: Maybe<Scalars['String']['output']>;
+  /** The type of the clip, eg. 'http://www.ft.com/ontology/content/Clip'. */
   readonly type?: Maybe<Scalars['String']['output']>;
 };
 
 export type ClipSet = Reference & {
+  /** An object containing the accessibility details of the clip. */
   readonly accessibility?: Maybe<Accessibility>;
+  /** Whether the clip should play automatically when loaded. */
   readonly autoplay?: Maybe<Scalars['Boolean']['output']>;
+  /** Text describing the content of the clip, to be shown next to the clip. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** An array of clips in the clip set. */
   readonly clips?: Maybe<ReadonlyArray<Maybe<Clip>>>;
+  /** An array of content warnings for the clip set. */
   readonly contentWarning?: Maybe<ReadonlyArray<Maybe<Scalars['String']['output']>>>;
+  /** The credit text of the clip, eg. 'Getty Images'. */
   readonly credits?: Maybe<Scalars['String']['output']>;
+  /** The layout of the clip set, eg. 'in-line'. */
   readonly dataLayout?: Maybe<Scalars['String']['output']>;
+  /** The description of the clip. */
   readonly description?: Maybe<Scalars['String']['output']>;
+  /** The title to be displayed for the clip set. */
   readonly displayTitle?: Maybe<Scalars['String']['output']>;
+  /** The unique identifier of the clip set. */
   readonly id: Scalars['String']['output'];
+  /** Whether the clip should loop. */
   readonly loop?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the clip should be muted. */
   readonly muted?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the clip set should **not** include audio. */
   readonly noAudio?: Maybe<Scalars['Boolean']['output']>;
+  /** The date the clip set was published. */
   readonly publishedDate?: Maybe<Scalars['String']['output']>;
+  /** The source of the clip set, eg. 'YouTube'. */
   readonly source?: Maybe<Scalars['String']['output']>;
+  /** The subtitle of the clip set. */
   readonly subtitle?: Maybe<Scalars['String']['output']>;
+  /** The type of the clip set, eg. 'video'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type ClipSource = {
+  /** The audio encoding format of the source, eg. mp3. */
   readonly audioCodec?: Maybe<Scalars['String']['output']>;
+  /** The url of the clip source, eg. 'https://next-media-api.ft.com/renditions/16868569859480/0x0.mp3'. */
   readonly binaryUrl: Scalars['String']['output'];
+  /** The duration of the clip in milliseconds. */
   readonly duration?: Maybe<Scalars['Int']['output']>;
+  /** The media type eg. video/mp4. */
   readonly mediaType: Scalars['String']['output'];
+  /** The height of the clip in pixels. */
   readonly pixelHeight?: Maybe<Scalars['Int']['output']>;
+  /** The width of the clip in pixels. */
   readonly pixelWidth?: Maybe<Scalars['Int']['output']>;
+  /** The video encoding format of the source, eg. h264. */
   readonly videoCodec?: Maybe<Scalars['String']['output']>;
 };
 
+/** A concept is supplemtary information item, like a location, person, organisation or topic. It is used to provide context to an article. */
 export type Concept = {
+  /** The api url of the concept, eg. 'http://api.ft.com/things/a579350c-61ce-4c00-97ca-ddaa2e0cacf6'. */
   readonly apiUrl?: Maybe<Scalars['String']['output']>;
+  /** The type of the concept, eg. 'http://www.ft.com/ontology/Topic'. */
   readonly directType?: Maybe<Scalars['String']['output']>;
+  /** The unique identifier of the concept -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** Whether the concept is part of a package brand eg. 'ftSeries' or 'ftGuides'. */
   readonly isPackageBrand?: Maybe<Scalars['Boolean']['output']>;
+  /** The relationship between the concept and the article, eg. 'http://www.ft.com/ontology/hasAuthor'. */
   readonly predicate?: Maybe<Scalars['String']['output']>;
+  /** The preferred label of the concept, eg. 'Work & Careers'. */
   readonly prefLabel: Scalars['String']['output'];
+  /** The type of the concept, eg. 'TOPIC'. */
   readonly type?: Maybe<Scalars['String']['output']>;
+  /** An array of types, eg. ['http://www.ft.com/ontology/core/Thing', 'http://www.ft.com/ontology/Topic']. */
   readonly types?: Maybe<ReadonlyArray<Scalars['String']['output']>>;
+  /** The url of the media, eg. 'https://next-media-api.ft.com/renditions/16868569859480/0x0.mp3'. */
   readonly url: Scalars['String']['output'];
 };
 
 
+/** A concept is supplemtary information item, like a location, person, organisation or topic. It is used to provide context to an article. */
 export type ConceptUrlArgs = {
   relative?: InputMaybe<Scalars['Boolean']['input']>;
   vanity?: InputMaybe<Scalars['Boolean']['input']>;
 };
 
 export type Content = {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -252,31 +388,57 @@ export type ContentUrlArgs = {
 };
 
 export type ContentPackage = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** The child articles of this content package. */
   readonly contains?: Maybe<ReadonlyArray<Maybe<Teaser>>>;
+  /** The number of child articles in this content package. */
   readonly containsLength?: Maybe<Scalars['Int']['output']>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** The optional table of contents for this content package. */
   readonly tableOfContents?: Maybe<TableOfContents>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -298,79 +460,135 @@ export type ContentPackageUrlArgs = {
 };
 
 export type DeepLandscapeTopper = Topper & TopperWithBrand & TopperWithImages & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** A fallback image to be used if the 'images' are not availableimages: [Image!]!. */
   readonly fallbackImage?: Maybe<Image>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An array of images to be displayed on the topper. */
   readonly images: ReadonlyArray<Image>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type DeepPortraitTopper = Topper & TopperWithBrand & TopperWithImages & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** A fallback image to be used if the 'images' are not availableimages: [Image!]!. */
   readonly fallbackImage?: Maybe<Image>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An array of images to be displayed on the topper. */
   readonly images: ReadonlyArray<Image>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type Design = {
+  /** The layout, eg. 'default'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** A scalar representing the theme of the design, eg. 'extra-wide'. */
   readonly theme?: Maybe<Scalars['PackageDesign']['output']>;
 };
 
 export type Flourish = Reference & {
+  /** The fallback image to be used if the flourish graphics cannot be loaded. */
   readonly fallbackImage?: Maybe<FlourishFallback>;
+  /** The type of the reference, eg. 'flourish'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type FlourishFallback = {
+  /** The height in pixels of the fallback image. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The url of the fallback image. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width in pixels of the fallback image. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
 export type FullBleedTopper = Topper & TopperWithBrand & TopperWithImages & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** A fallback image to be used if the 'images' are not availableimages: [Image!]!. */
   readonly fallbackImage?: Maybe<Image>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An array of images to be displayed on the topper. */
   readonly images: ReadonlyArray<Image>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type Image = {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -381,15 +599,25 @@ export type ImageSourceSetArgs = {
 };
 
 export type ImageDesktop = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -400,15 +628,25 @@ export type ImageDesktopSourceSetArgs = {
 };
 
 export type ImageLandscape = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -419,15 +657,25 @@ export type ImageLandscapeSourceSetArgs = {
 };
 
 export type ImageMobile = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -438,15 +686,25 @@ export type ImageMobileSourceSetArgs = {
 };
 
 export type ImagePortrait = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -457,26 +715,41 @@ export type ImagePortraitSourceSetArgs = {
 };
 
 export type ImageSet = Reference & {
+  /** A set of images with different sizes and formats. */
   readonly picture?: Maybe<Picture>;
+  /** The type of the reference, eg. 'image-set'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type ImageSource = {
+  /** The device pixel ratio. DPR is calculated as DPR = Physical Pixels (pixels seen on screen) / Logical Pixels (pixel that can fit in a given space). */
   readonly dpr?: Maybe<Scalars['Int']['output']>;
+  /** The url of the image source, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url: Scalars['String']['output'];
+  /** The width of the image source in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
 export type ImageSquare = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -487,15 +760,25 @@ export type ImageSquareSourceSetArgs = {
 };
 
 export type ImageSquareFtEdit = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -506,15 +789,25 @@ export type ImageSquareFtEditSourceSetArgs = {
 };
 
 export type ImageStandard = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -525,15 +818,25 @@ export type ImageStandardSourceSetArgs = {
 };
 
 export type ImageStandardInline = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -544,15 +847,25 @@ export type ImageStandardInlineSourceSetArgs = {
 };
 
 export type ImageWide = Image & {
+  /** Text describing the content of the image, usually hidden from the user unless the image is not available. It is to be read by screen readers. */
   readonly altText?: Maybe<Scalars['String']['output']>;
+  /** Text describing the content of the image, always shown next to the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** The format of the image, eg. 'portrait'. */
   readonly format: Scalars['ImageFormat']['output'];
+  /** The height of the image in pixels. */
   readonly height?: Maybe<Scalars['Int']['output']>;
+  /** The unique identifier of the image -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** An array of image sources, ie. different images to render based on input width resulting in responsive images. */
   readonly sourceSet: ReadonlyArray<ImageSource>;
+  /** The type of the image, eg. 'graphic'. */
   readonly type?: Maybe<Scalars['ImageType']['output']>;
+  /** The url of the image, eg. 'https://www.ft.com/__origami/service/image/v2/images/raw/ftcms%3Aimage%3A0e7e7b6e-4e7b-11e9-bde6-79e4b4311f90?source=next&fit=scale-down&width=700'. */
   readonly url?: Maybe<Scalars['String']['output']>;
+  /** The width of the image in pixels. */
   readonly width?: Maybe<Scalars['Int']['output']>;
 };
 
@@ -562,47 +875,83 @@ export type ImageWideSourceSetArgs = {
   width?: InputMaybe<Scalars['Int']['input']>;
 };
 
+/** Indicators are used to determine teaser styling. */
 export type Indicators = {
+  /** The access level of the teaser, eg. 'free' or 'premium'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** Whether the teaser is a column, ie. has one author. */
   readonly isColumn?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the teaser is an editor's choice. */
   readonly isEditorsChoice?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the teaser is exclusive. */
   readonly isExclusive?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the teaser is an opinion piece. */
   readonly isOpinion?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the teaser is a podcast. */
   readonly isPodcast?: Maybe<Scalars['Boolean']['output']>;
+  /** Whether the teaser is a scoop. */
   readonly isScoop?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type LayoutImage = Reference & {
+  /** A set of images with different sizes and formats. */
   readonly picture?: Maybe<Picture>;
+  /** The type of the reference, eg. 'layout-image'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type LiveBlogPackage = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** The child articles of this live blog package. */
   readonly liveBlogPosts?: Maybe<ReadonlyArray<Maybe<Content>>>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The pinned article of this live blog package. */
   readonly pinnedPost?: Maybe<Content>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** Whether the live blog package should be updated in real time. */
   readonly realtime?: Maybe<Scalars['Boolean']['output']>;
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -623,31 +972,57 @@ export type LiveBlogPackageUrlArgs = {
 };
 
 export type LiveBlogPost = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** The parent article, indicating this article is a part of a series or package. */
   readonly containedIn?: Maybe<Content>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** An object indicating whether the article is an opinion piece. */
   readonly indicators?: Maybe<Indicators>;
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** Whether the live-blog-post should be pinned. */
   readonly isPinned?: Maybe<Scalars['Boolean']['output']>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -663,20 +1038,27 @@ export type LiveBlogPostUrlArgs = {
 };
 
 export type MainImage = Reference & {
+  /** A set of images with different sizes and formats. */
   readonly picture?: Maybe<Picture>;
+  /** The type of the reference, eg. 'main-image'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type Media = {
+  /** The duration of the media in milliseconds. */
   readonly duration?: Maybe<Scalars['Int']['output']>;
+  /** The filesize of the media in bytes. */
   readonly filesize?: Maybe<Scalars['Int']['output']>;
+  /** The media type eg. video/mp4. */
   readonly mediaType?: Maybe<Scalars['String']['output']>;
+  /** The url of the media, eg. 'https://next-media-api.ft.com/renditions/16868569859480/0x0.mp3'. */
   readonly url?: Maybe<Scalars['String']['output']>;
 };
 
 export type MetaLink = Concept | ContentPackage;
 
 export type Mutation = {
+  /** A mutation to invalidate the redis cache for content-api responses for a given uuid. */
   readonly invalidateRedisCache?: Maybe<Scalars['String']['output']>;
 };
 
@@ -686,17 +1068,29 @@ export type MutationInvalidateRedisCacheArgs = {
 };
 
 export type OpinionTopper = Topper & TopperWithHeadshot & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object describing details of the column author. */
   readonly columnist?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** The url of the headshot image, eg. for columns with one key author. */
   readonly headshot?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
@@ -706,70 +1100,123 @@ export type OpinionTopperHeadshotArgs = {
   width?: InputMaybe<Scalars['Int']['input']>;
 };
 
+/** A wrapper for images. */
 export type Picture = {
+  /** The alt text of the image to be used for accessibility. */
   readonly alt: Scalars['String']['output'];
+  /** The caption of the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** A fallback image to be used if the 'images' are not available. */
   readonly fallbackImage: Image;
+  /** The type of the image, eg. 'image' or 'graphic'. */
   readonly imageType: Scalars['ImageType']['output'];
+  /** A set of images with different sizes and formats. */
   readonly images: ReadonlyArray<Image>;
+  /** The layout width of the image, eg, 'standard'. */
   readonly layoutWidth?: Maybe<Scalars['String']['output']>;
 };
 
 export type PictureFullBleed = Picture & {
+  /** The alt text of the image to be used for accessibility. */
   readonly alt: Scalars['String']['output'];
+  /** The caption of the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** A fallback image to be used if the 'images' are not available. */
   readonly fallbackImage: Image;
+  /** The type of the image, eg. 'image' or 'graphic'. */
   readonly imageType: Scalars['ImageType']['output'];
+  /** A set of images with different sizes and formats. */
   readonly images: ReadonlyArray<Image>;
+  /** The layout width of the image, eg, 'standard'. */
   readonly layoutWidth?: Maybe<Scalars['String']['output']>;
 };
 
 export type PictureInline = Picture & {
+  /** The alt text of the image to be used for accessibility. */
   readonly alt: Scalars['String']['output'];
+  /** The caption of the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** A fallback image to be used if the 'images' are not available. */
   readonly fallbackImage: Image;
+  /** The type of the image, eg. 'image' or 'graphic'. */
   readonly imageType: Scalars['ImageType']['output'];
+  /** A set of images with different sizes and formats. */
   readonly images: ReadonlyArray<Image>;
+  /** The layout width of the image, eg, 'standard'. */
   readonly layoutWidth?: Maybe<Scalars['String']['output']>;
 };
 
 export type PictureStandard = Picture & {
+  /** The alt text of the image to be used for accessibility. */
   readonly alt: Scalars['String']['output'];
+  /** The caption of the image. */
   readonly caption?: Maybe<Scalars['String']['output']>;
+  /** The credit of the image, eg. 'Getty Images'. */
   readonly credit?: Maybe<Scalars['String']['output']>;
+  /** A fallback image to be used if the 'images' are not available. */
   readonly fallbackImage: Image;
+  /** The type of the image, eg. 'image' or 'graphic'. */
   readonly imageType: Scalars['ImageType']['output'];
+  /** A set of images with different sizes and formats. */
   readonly images: ReadonlyArray<Image>;
+  /** The layout width of the image, eg, 'standard'. */
   readonly layoutWidth?: Maybe<Scalars['String']['output']>;
 };
 
 export type Placeholder = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** The parent article, indicating this article is a part of a series or package. */
   readonly containedIn?: Maybe<Content>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -785,18 +1232,31 @@ export type PlaceholderUrlArgs = {
 };
 
 export type PodcastTopper = Topper & TopperWithBrand & TopperWithHeadshot & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object describing details of the column author. */
   readonly columnist?: Maybe<Concept>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** The url of the headshot image, eg. for columns with one key author. */
   readonly headshot?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
@@ -807,8 +1267,11 @@ export type PodcastTopperHeadshotArgs = {
 };
 
 export type Query = {
+  /** The resolved article content for given uuid. */
   readonly content: Content;
+  /** The article content as resolved from passed-in content-api json data. */
   readonly contentFromJSON: Content;
+  /** The version of the schema, eg. 2.0.0. */
   readonly version: Scalars['String']['output'];
 };
 
@@ -823,21 +1286,26 @@ export type QueryContentFromJsonArgs = {
 };
 
 export type RawImage = Reference & {
+  /** The raw image object. */
   readonly image: Image;
+  /** The type of the reference, eg. 'raw-image'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type Recommended = Reference & {
+  /** Recommended references contain teaser thumbnails of related articles. */
   readonly teaser?: Maybe<Teaser>;
+  /** The type of the reference, eg. 'recommended'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type Reference = {
+  /** The type of the reference, eg. 'image-set'. References are additional data that cannot be loaded by content-tree. They will be appended to content-tree nodes during resolution. */
   readonly type: Scalars['String']['output'];
 };
 
 export type RichText = {
-  /** Raw string of the XML as returned from ContentAPI. */
+  /** Raw string of the XML as returned from content-api. */
   readonly raw?: Maybe<Scalars['String']['output']>;
   /** The source format eg. bodyXML. */
   readonly source: Scalars['RichTextSource']['output'];
@@ -846,28 +1314,44 @@ export type RichText = {
 };
 
 export type ScrollyImage = Reference & {
+  /** A set of images with different sizes and formats. */
   readonly picture?: Maybe<Picture>;
+  /** The type of the reference, eg. 'scrolly-image'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type SplitTextTopper = Topper & TopperWithBrand & TopperWithImages & TopperWithPackage & TopperWithTheme & {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The design of the topper, eg. 'standard'. */
   readonly design?: Maybe<Scalars['String']['output']>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** A fallback image to be used if the 'images' are not availableimages: [Image!]!. */
   readonly fallbackImage?: Maybe<Image>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An array of images to be displayed on the topper. */
   readonly images: ReadonlyArray<Image>;
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
-/** Describes the structure of content as an abstract syntax tree */
+/** Describes the structure of content as an abstract syntax tree. */
 export type StructuredContent = {
   /** An array of objects containing extra information for nodes, which is fetched from external sources eg. Twitter API. */
   readonly references: ReadonlyArray<Reference>;
@@ -878,24 +1362,40 @@ export type StructuredContent = {
 };
 
 export type TableOfContents = {
+  /** The formatting of the label, eg. 'part-number'. */
   readonly labelType?: Maybe<Scalars['String']['output']>;
+  /** The ordering, eg. 'exact-order'. */
   readonly sequence?: Maybe<Scalars['String']['output']>;
 };
 
 export type Teaser = {
+  /** The date the content of the teaser was first published. */
   readonly firstPublishedDate?: Maybe<Scalars['String']['output']>;
+  /** The unique identifier of the teaser,  a uuid or a url. */
   readonly id?: Maybe<Scalars['String']['output']>;
+  /** The image to be used as a thumbnail for the teaser. */
   readonly image?: Maybe<Image>;
+  /** An object containing a map of indicator items to boolean values, eg. accessLevel, isOpinion. */
   readonly indicators?: Maybe<Indicators>;
+  /** An object containing the metadata details of the teaser, eg. id, url, prefLabel. */
   readonly metaAltLink?: Maybe<MetaLink>;
+  /** An object containing the metadata details of the teaser, eg. id, url, prefLabel. */
   readonly metaLink?: Maybe<MetaLink>;
+  /** The text to be displayed before the metadata of the teaser. */
   readonly metaPrefixText?: Maybe<Scalars['String']['output']>;
+  /** The text to be displayed after the metadata of the teaser. */
   readonly metaSuffixText?: Maybe<Scalars['String']['output']>;
+  /** The date the content of the teaser was published. */
   readonly publishedDate?: Maybe<Scalars['String']['output']>;
+  /** The introductory text of the teaser. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** The theme to use for the teaser, eg. 'opinion' or 'news'. */
   readonly theme?: Maybe<Scalars['String']['output']>;
+  /** The title of the teaser. */
   readonly title?: Maybe<Scalars['String']['output']>;
+  /** The type of the teaser, eg. 'article' or 'video'. */
   readonly type?: Maybe<Scalars['String']['output']>;
+  /** The url of the content that the teaser refers to. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -905,22 +1405,33 @@ export type TeaserUrlArgs = {
 };
 
 export type Topper = {
+  /** Whether the topper should have a background box. */
   readonly backgroundBox?: Maybe<Scalars['Boolean']['output']>;
+  /** The background colour of the topper. */
   readonly backgroundColour?: Maybe<Scalars['TopperBackgroundColour']['output']>;
+  /** The concept object to be displayed, eg. {'type': 'TOPIC', 'prefLabel': 'Non-dom tax status', ...}. */
   readonly displayConcept?: Maybe<Concept>;
+  /** The variant of the follow button to be displayed on the topper. */
   readonly followButtonVariant?: Maybe<Scalars['FollowButtonVariant']['output']>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
+  /** The headline text of the topper. */
   readonly headline: Scalars['String']['output'];
+  /** An abstract syntax tree of the introduction text. */
   readonly intro?: Maybe<RichText>;
+  /** Whether the topper should have a text shadow. */
   readonly textShadow?: Maybe<Scalars['Boolean']['output']>;
 };
 
 export type TopperWithBrand = {
+  /** The concept object of the brand, eg. {'type': 'BRAND', 'prefLabel': 'FT Magazine', ...}. */
   readonly brandConcept?: Maybe<Concept>;
+  /** The concept object of the genre, eg. {'type': 'GENRE', 'prefLabel': 'Opinion', ...}. */
   readonly genreConcept?: Maybe<Concept>;
 };
 
 export type TopperWithHeadshot = {
+  /** The url of the headshot image, eg. for columns with one key author. */
   readonly headshot?: Maybe<Scalars['String']['output']>;
 };
 
@@ -931,47 +1442,77 @@ export type TopperWithHeadshotHeadshotArgs = {
 };
 
 export type TopperWithImages = {
+  /** A fallback image to be used if the 'images' are not available. */
   readonly fallbackImage?: Maybe<Image>;
+  /** An array of images to be displayed on the topper. */
   readonly images: ReadonlyArray<Image>;
 };
 
 export type TopperWithPackage = {
+  /** The design of the topper, eg. 'standard'. */
   readonly design?: Maybe<Scalars['String']['output']>;
 };
 
 export type TopperWithTheme = {
+  /** Whether the headline should be large. */
   readonly isLargeHeadline?: Maybe<Scalars['Boolean']['output']>;
+  /** The layout of the topper, eg. 'split-text-left'. */
   readonly layout?: Maybe<Scalars['String']['output']>;
 };
 
 export type Tweet = Reference & {
+  /** The raw HTML of the tweet. */
   readonly html?: Maybe<Scalars['String']['output']>;
+  /** The type of the reference, eg. 'tweet'. */
   readonly type: Scalars['String']['output'];
 };
 
 export type Video = Content & {
+  /** A scalar representing the access level of the article, eg. 'free'. */
   readonly accessLevel?: Maybe<Scalars['AccessLevel']['output']>;
+  /** An alternative introductory paragraph of the article. */
   readonly altStandfirst?: Maybe<AltStandfirst>;
+  /** An alternative title of the article. */
   readonly altTitle?: Maybe<AltTitle>;
+  /** An array of concepts related to the article, eg. organisations or topics. */
   readonly annotations?: Maybe<ReadonlyArray<Maybe<Concept>>>;
+  /** An abstract syntax tree of the article content. */
   readonly body?: Maybe<RichText>;
+  /** The raw string of the XML as returned from ContentAPI. */
   readonly bodyXML?: Maybe<Scalars['String']['output']>;
+  /** An abstract syntax tree of the authors of the article. */
   readonly byline?: Maybe<StructuredContent>;
+  /** A scalar representing whether the article can be syndicated, ie. published by a third party site. */
   readonly canBeSyndicated?: Maybe<Scalars['CanBeSyndicated']['output']>;
+  /** Whether comments are enabled on the article. */
   readonly commentsEnabled?: Maybe<Scalars['Boolean']['output']>;
+  /** A design object containing the theme and layout of the article. */
   readonly design?: Maybe<Design>;
+  /** The editorial division the article belongs to, eg. 'FT-SpecialReports'. */
   readonly editorialDesk?: Maybe<Scalars['String']['output']>;
+  /** The first ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly firstPublishedDate: Scalars['String']['output'];
+  /** The unique identifier of the article -  a uuid or a url. */
   readonly id: Scalars['ID']['output'];
+  /** The concept to use for instant alert CTAs. */
   readonly instantAlertConcept?: Maybe<Concept>;
+  /** An image object containing the url and the caption, to be displayed usually before the article content. */
   readonly mainImage?: Maybe<Image>;
+  /** The party that originated the article, eg. 'FT'. */
   readonly originatingParty?: Maybe<Scalars['String']['output']>;
+  /** The ISO string date the article was published, eg. '2024-04-03T10:35:52.443Z'. */
   readonly publishedDate: Scalars['String']['output'];
+  /** An introductory paragraph of the article. */
   readonly standfirst?: Maybe<Scalars['String']['output']>;
+  /** A promotional thumbnail / snapshot of the article. */
   readonly teaser?: Maybe<Teaser>;
+  /** The title of the article. */
   readonly title: Scalars['String']['output'];
+  /** A banner located usually at the top of articles containing the title, the standfirst and any images. */
   readonly topper?: Maybe<Topper>;
+  /** The type of the article, eg. 'Article' or 'Video'. */
   readonly type: Scalars['ContentType']['output'];
+  /** The url of the concept. Vanity urls replace long, randomly generated urls - they are more user friendly and concise. Relative urls are relative to the current domain. */
   readonly url: Scalars['String']['output'];
 };
 
@@ -987,8 +1528,11 @@ export type VideoUrlArgs = {
 };
 
 export type VideoReference = Reference & {
+  /** The unique identifier of the video -  a uuid or a url. */
   readonly id: Scalars['String']['output'];
+  /** The title of the video. */
   readonly title: Scalars['String']['output'];
+  /** The type of the reference, eg. 'video'. */
   readonly type: Scalars['String']['output'];
 };