Update writing advice article

Author: wiseodd

.astro/content-modules.mjs

@@ -1,24 +1,24 @@
 
 export default new Map([
 ["src/content/post/autoencoders.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fautoencoders.mdx&astroContentModuleFlag=true")],
-["src/content/post/brouwers-fixed-point.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fbrouwers-fixed-point.mdx&astroContentModuleFlag=true")],
+["src/content/post/batchnorm.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fbatchnorm.mdx&astroContentModuleFlag=true")],
 ["src/content/post/boundary-seeking-gan.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fboundary-seeking-gan.mdx&astroContentModuleFlag=true")],
 ["src/content/post/bayesian-regression.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fbayesian-regression.mdx&astroContentModuleFlag=true")],
-["src/content/post/conditional-gan-tensorflow.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconditional-gan-tensorflow.mdx&astroContentModuleFlag=true")],
 ["src/content/post/annealed-importance-sampling.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fannealed-importance-sampling.mdx&astroContentModuleFlag=true")],
-["src/content/post/batchnorm.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fbatchnorm.mdx&astroContentModuleFlag=true")],
-["src/content/post/chentsov-theorem.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fchentsov-theorem.mdx&astroContentModuleFlag=true")],
+["src/content/post/brouwers-fixed-point.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fbrouwers-fixed-point.mdx&astroContentModuleFlag=true")],
 ["src/content/post/contractive-autoencoder.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fcontractive-autoencoder.mdx&astroContentModuleFlag=true")],
+["src/content/post/chentsov-theorem.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fchentsov-theorem.mdx&astroContentModuleFlag=true")],
+["src/content/post/conditional-gan-tensorflow.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconditional-gan-tensorflow.mdx&astroContentModuleFlag=true")],
 ["src/content/post/conditional-vae.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconditional-vae.mdx&astroContentModuleFlag=true")],
 ["src/content/post/conv-probit.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconv-probit.mdx&astroContentModuleFlag=true")],
+["src/content/post/convnet-maxpool-layer.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconvnet-maxpool-layer.mdx&astroContentModuleFlag=true")],
 ["src/content/post/convnet-conv-layer.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconvnet-conv-layer.mdx&astroContentModuleFlag=true")],
 ["src/content/post/coupled-gan.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fcoupled-gan.mdx&astroContentModuleFlag=true")],
 ["src/content/post/deploying-wagtail.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fdeploying-wagtail.mdx&astroContentModuleFlag=true")],
-["src/content/post/convnet-maxpool-layer.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fconvnet-maxpool-layer.mdx&astroContentModuleFlag=true")],
-["src/content/post/dropout.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fdropout.mdx&astroContentModuleFlag=true")],
 ["src/content/post/developing-wagtail.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fdeveloping-wagtail.mdx&astroContentModuleFlag=true")],
-["src/content/post/fisher-information.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Ffisher-information.mdx&astroContentModuleFlag=true")],
+["src/content/post/dropout.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fdropout.mdx&astroContentModuleFlag=true")],
 ["src/content/post/forward-reverse-kl.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fforward-reverse-kl.mdx&astroContentModuleFlag=true")],
+["src/content/post/fisher-information.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Ffisher-information.mdx&astroContentModuleFlag=true")],
 ["src/content/post/gan-pytorch.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fgan-pytorch.mdx&astroContentModuleFlag=true")],
 ["src/content/post/gan-tensorflow.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fgan-tensorflow.mdx&astroContentModuleFlag=true")],
 ["src/content/post/gaussian-anomaly-detection.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fgaussian-anomaly-detection.mdx&astroContentModuleFlag=true")],
@@ -31,30 +31,30 @@ export default new Map([
 ["src/content/post/jekyll-fb-share.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fjekyll-fb-share.mdx&astroContentModuleFlag=true")],
 ["src/content/post/kl-mle.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fkl-mle.mdx&astroContentModuleFlag=true")],
 ["src/content/post/laplace.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flaplace.mdx&astroContentModuleFlag=true")],
-["src/content/post/lda-gibbs.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flda-gibbs.mdx&astroContentModuleFlag=true")],
 ["src/content/post/least-squares-gan.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fleast-squares-gan.mdx&astroContentModuleFlag=true")],
 ["src/content/post/levelset-method.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flevelset-method.mdx&astroContentModuleFlag=true")],
 ["src/content/post/levelset-segmentation.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flevelset-segmentation.mdx&astroContentModuleFlag=true")],
-["src/content/post/manifold-gaussians.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmanifold-gaussians.mdx&astroContentModuleFlag=true")],
 ["src/content/post/lstm-backprop.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flstm-backprop.mdx&astroContentModuleFlag=true")],
-["src/content/post/mayer-vietoris-sphere.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmayer-vietoris-sphere.mdx&astroContentModuleFlag=true")],
-["src/content/post/minkowski-dirichlet.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fminkowski-dirichlet.mdx&astroContentModuleFlag=true")],
+["src/content/post/manifold-gaussians.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmanifold-gaussians.mdx&astroContentModuleFlag=true")],
 ["src/content/post/metropolis-hastings.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmetropolis-hastings.mdx&astroContentModuleFlag=true")],
+["src/content/post/lda-gibbs.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Flda-gibbs.mdx&astroContentModuleFlag=true")],
+["src/content/post/minkowski-dirichlet.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fminkowski-dirichlet.mdx&astroContentModuleFlag=true")],
+["src/content/post/mayer-vietoris-sphere.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmayer-vietoris-sphere.mdx&astroContentModuleFlag=true")],
 ["src/content/post/mle-vs-map.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fmle-vs-map.mdx&astroContentModuleFlag=true")],
 ["src/content/post/natural-gradient.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fnatural-gradient.mdx&astroContentModuleFlag=true")],
 ["src/content/post/nn-optimization.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fnn-optimization.mdx&astroContentModuleFlag=true")],
-["src/content/post/nn-sgd.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fnn-sgd.mdx&astroContentModuleFlag=true")],
 ["src/content/post/optimization-riemannian-manifolds.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Foptimization-riemannian-manifolds.mdx&astroContentModuleFlag=true")],
+["src/content/post/nn-sgd.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fnn-sgd.mdx&astroContentModuleFlag=true")],
 ["src/content/post/parallel-monte-carlo.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fparallel-monte-carlo.mdx&astroContentModuleFlag=true")],
 ["src/content/post/plotting.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fplotting.mdx&astroContentModuleFlag=true")],
 ["src/content/post/rejection-sampling.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Frejection-sampling.mdx&astroContentModuleFlag=true")],
 ["src/content/post/residual-net.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fresidual-net.mdx&astroContentModuleFlag=true")],
 ["src/content/post/scrapy-long-running.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fscrapy-long-running.mdx&astroContentModuleFlag=true")],
+["src/content/post/slice-sampling.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fslice-sampling.mdx&astroContentModuleFlag=true")],
 ["src/content/post/theano-pde.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Ftheano-pde.mdx&astroContentModuleFlag=true")],
+["src/content/post/twitter-auth-flask.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Ftwitter-auth-flask.mdx&astroContentModuleFlag=true")],
 ["src/content/post/vae-pytorch.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fvae-pytorch.mdx&astroContentModuleFlag=true")],
-["src/content/post/slice-sampling.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fslice-sampling.mdx&astroContentModuleFlag=true")],
 ["src/content/post/variational-autoencoder.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fvariational-autoencoder.mdx&astroContentModuleFlag=true")],
-["src/content/post/twitter-auth-flask.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Ftwitter-auth-flask.mdx&astroContentModuleFlag=true")],
 ["src/content/post/volume-form.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fvolume-form.mdx&astroContentModuleFlag=true")],
 ["src/content/post/wagtail-dev-env.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fwagtail-dev-env.mdx&astroContentModuleFlag=true")],
 ["src/content/post/wasserstein-gan.mdx", () => import("astro:content-layer-deferred-module?astro%3Acontent-layer-deferred-module=&fileName=src%2Fcontent%2Fpost%2Fwasserstein-gan.mdx&astroContentModuleFlag=true")],

.astro/content.d.ts

@@ -1,7 +1,7 @@
 declare module 'astro:content' {
 	interface Render {
 		'.mdx': Promise<{
-			Content: import('astro').MarkdownInstance<{}>['Content'];
+			Content: import('astro').MDXContent;
 			headings: import('astro').MarkdownHeading[];
 			remarkPluginFrontmatter: Record<string, any>;
 			components: import('astro').MDXInstance<{}>['components'];
@@ -42,6 +42,25 @@ declare module 'astro:content' {
 		ContentEntryMap[C]
 	>['slug'];
 
+	export type ReferenceDataEntry<
+		C extends CollectionKey,
+		E extends keyof DataEntryMap[C] = string,
+	> = {
+		collection: C;
+		id: E;
+	};
+	export type ReferenceContentEntry<
+		C extends keyof ContentEntryMap,
+		E extends ValidContentEntrySlug<C> | (string & {}) = string,
+	> = {
+		collection: C;
+		slug: E;
+	};
+	export type ReferenceLiveEntry<C extends keyof LiveContentConfig['collections']> = {
+		collection: C;
+		id: string;
+	};
+
 	/** @deprecated Use `getEntry` instead. */
 	export function getEntryBySlug<
 		C extends keyof ContentEntryMap,
@@ -69,22 +88,27 @@ declare module 'astro:content' {
 		filter?: (entry: CollectionEntry<C>) => unknown,
 	): Promise<CollectionEntry<C>[]>;
 
+	export function getLiveCollection<C extends keyof LiveContentConfig['collections']>(
+		collection: C,
+		filter?: LiveLoaderCollectionFilterType<C>,
+	): Promise<
+		import('astro').LiveDataCollectionResult<LiveLoaderDataType<C>, LiveLoaderErrorType<C>>
+	>;
+
 	export function getEntry<
 		C extends keyof ContentEntryMap,
 		E extends ValidContentEntrySlug<C> | (string & {}),
-	>(entry: {
-		collection: C;
-		slug: E;
-	}): E extends ValidContentEntrySlug<C>
+	>(
+		entry: ReferenceContentEntry<C, E>,
+	): E extends ValidContentEntrySlug<C>
 		? Promise<CollectionEntry<C>>
 		: Promise<CollectionEntry<C> | undefined>;
 	export function getEntry<
 		C extends keyof DataEntryMap,
 		E extends keyof DataEntryMap[C] | (string & {}),
-	>(entry: {
-		collection: C;
-		id: E;
-	}): E extends keyof DataEntryMap[C]
+	>(
+		entry: ReferenceDataEntry<C, E>,
+	): E extends keyof DataEntryMap[C]
 		? Promise<DataEntryMap[C][E]>
 		: Promise<CollectionEntry<C> | undefined>;
 	export function getEntry<
@@ -107,19 +131,17 @@ declare module 'astro:content' {
 			? Promise<DataEntryMap[C][E]> | undefined
 			: Promise<DataEntryMap[C][E]>
 		: Promise<CollectionEntry<C> | undefined>;
+	export function getLiveEntry<C extends keyof LiveContentConfig['collections']>(
+		collection: C,
+		filter: string | LiveLoaderEntryFilterType<C>,
+	): Promise<import('astro').LiveDataEntryResult<LiveLoaderDataType<C>, LiveLoaderErrorType<C>>>;
 
 	/** Resolve an array of entry references from the same collection */
 	export function getEntries<C extends keyof ContentEntryMap>(
-		entries: {
-			collection: C;
-			slug: ValidContentEntrySlug<C>;
-		}[],
+		entries: ReferenceContentEntry<C, ValidContentEntrySlug<C>>[],
 	): Promise<CollectionEntry<C>[]>;
 	export function getEntries<C extends keyof DataEntryMap>(
-		entries: {
-			collection: C;
-			id: keyof DataEntryMap[C];
-		}[],
+		entries: ReferenceDataEntry<C, keyof DataEntryMap[C]>[],
 	): Promise<CollectionEntry<C>[]>;
 
 	export function render<C extends keyof AnyEntryMap>(
@@ -131,14 +153,8 @@ declare module 'astro:content' {
 	): import('astro/zod').ZodEffects<
 		import('astro/zod').ZodString,
 		C extends keyof ContentEntryMap
-			? {
-					collection: C;
-					slug: ValidContentEntrySlug<C>;
-				}
-			: {
-					collection: C;
-					id: keyof DataEntryMap[C];
-				}
+			? ReferenceContentEntry<C, ValidContentEntrySlug<C>>
+			: ReferenceDataEntry<C, keyof DataEntryMap[C]>
 	>;
 	// Allow generic `string` to avoid excessive type errors in the config
 	// if `dev` is not running to update as you edit.
@@ -180,5 +196,33 @@ declare module 'astro:content' {
 
 	type AnyEntryMap = ContentEntryMap & DataEntryMap;
 
+	type ExtractLoaderTypes<T> = T extends import('astro/loaders').LiveLoader<
+		infer TData,
+		infer TEntryFilter,
+		infer TCollectionFilter,
+		infer TError
+	>
+		? { data: TData; entryFilter: TEntryFilter; collectionFilter: TCollectionFilter; error: TError }
+		: { data: never; entryFilter: never; collectionFilter: never; error: never };
+	type ExtractDataType<T> = ExtractLoaderTypes<T>['data'];
+	type ExtractEntryFilterType<T> = ExtractLoaderTypes<T>['entryFilter'];
+	type ExtractCollectionFilterType<T> = ExtractLoaderTypes<T>['collectionFilter'];
+	type ExtractErrorType<T> = ExtractLoaderTypes<T>['error'];
+
+	type LiveLoaderDataType<C extends keyof LiveContentConfig['collections']> =
+		LiveContentConfig['collections'][C]['schema'] extends undefined
+			? ExtractDataType<LiveContentConfig['collections'][C]['loader']>
+			: import('astro/zod').infer<
+					Exclude<LiveContentConfig['collections'][C]['schema'], undefined>
+				>;
+	type LiveLoaderEntryFilterType<C extends keyof LiveContentConfig['collections']> =
+		ExtractEntryFilterType<LiveContentConfig['collections'][C]['loader']>;
+	type LiveLoaderCollectionFilterType<C extends keyof LiveContentConfig['collections']> =
+		ExtractCollectionFilterType<LiveContentConfig['collections'][C]['loader']>;
+	type LiveLoaderErrorType<C extends keyof LiveContentConfig['collections']> = ExtractErrorType<
+		LiveContentConfig['collections'][C]['loader']
+	>;
+
 	export type ContentConfig = typeof import("../src/content/config.js");
+	export type LiveContentConfig = never;
 }