release assets

Author: mProjectsCode

.vscode/settings.json

@@ -5,5 +5,7 @@
 		"pluginRepos": true,
 		"data/out/plugin-repos/**": true
 	},
-	"rust-analyzer.files.exclude": ["data/out/**"]
+	"rust-analyzer.files.exclude": [
+		"data/out/**"
+	]
 }

data-lib/src/release/mod.rs

@@ -114,10 +114,10 @@ pub fn get_asset_release_file_type(file_name: &str) -> Option<String> {
 
 pub fn get_asset_cpu_instruction_set(file_name: &str) -> Option<&'static str> {
     if file_name.ends_with(".dmg") {
-        Some("both")
+        Some("both (.dmg)")
     } else if file_name.contains("arm64") {
         Some("arm64")
     } else {
-        Some("x64")
+        Some("x86")
     }
 }

website/astro.config.mjs

@@ -83,6 +83,10 @@ export default defineConfig({
 							label: 'Downloads',
 							link: '/releasestats/downloads',
 						},
+						{
+							label: 'Assets',
+							link: '/releasestats/assets',
+						},
 					],
 				},
 			],

website/src/components/Commit.astro

@@ -1,25 +1,7 @@
 ---
-import { type Commit } from '../../../src/types';
+import type { StringCommit } from "../../../data-wasm/pkg/data_wasm";
 
-const props = Astro.props as { commit: Commit } | { date: string; hash: string };
-
-function getHash(): string {
-	if ('commit' in props) {
-		return props.commit.hash;
-	} else {
-		return props.hash;
-	}
-}
-
-function getDate(): string {
-	if ('commit' in props) {
-		return props.commit.date;
-	} else {
-		return props.date;
-	}
-}
-
-const url = 'https://github.com/obsidianmd/obsidian-releases/commit/' + getHash();
+const props = Astro.props as { commit: StringCommit };
 ---
 
-<a href={url} target="_blank">{getDate()}</a>
+<a href={'https://github.com/obsidianmd/obsidian-releases/commit/' + props.commit.hash} target="_blank">{props.commit.date}</a>

website/src/pages/releasestats/assets.astro

@@ -0,0 +1,52 @@
+---
+import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
+import StackedXBarChart from '../../components/newSvelte/charts/StackedXBarChart.svelte';
+import AssetSizeChart from '../../components/newSvelte/charts/release/AssetSizeChart.svelte';
+import { getReleaseDataArray } from '../../utils/data';
+
+const dataArray = await getReleaseDataArray();
+
+const assetTypes = dataArray.get_asset_type_percentages();
+const assetSize = dataArray.get_asset_size_by_version();
+const assetInstructionSet = dataArray.get_asset_instruction_set_percentages();
+---
+
+<StarlightPage
+	frontmatter={{
+		title: 'Release Assets',
+		description: `Stats about the asset types and sizes of Obsidian releases.`,
+	}}
+	headings={[]}
+>
+
+    <p>
+        This page looks at the assets that are included in Obsidian releases, including the types of assets, their sizes, and what type of PCs they are for.
+    </p>
+
+    <p>
+        The following graph groups the assets by type. 
+        The first bar shows the distribution of downloads among the different asset types.
+        The second bar shows the distribution of how many assets of each type are included in all releases.
+        The third bar shows the distribution of the average sizes of each asset type.
+    </p>
+
+	<p><StackedXBarChart dataPoints={assetTypes} percentages client:only="svelte" /></p>
+
+    <p>
+        The next graph shows the evolution of asset sizes over time. 
+        The data is split by asset type. 
+        Note that gaps may appear, as not every asset type is included in every release.
+    </p>
+
+	<p><AssetSizeChart dataPoints={assetSize} client:only="svelte" /></p>
+
+    <p>
+        This graph shows the split between downloads of assets for different instruction sets.
+        The instruction set is the type of CPU architecture that the asset is built for, such as x86 or ARM.
+        From this we can see that downloads for ARM make up only {assetInstructionSet.find((x) => x.layer === 'arm64')?.value?.toFixed(1)}% of the total downloads. 
+        The macOS <code>.dmg</code> assets make up the <code>both (.dmg)</code> category with {assetInstructionSet.find((x) => x.layer === 'both (.dmg)')?.value?.toFixed(1)}%, as they can be used on both x86 and ARM Macs.
+    </p>
+
+	<p><StackedXBarChart dataPoints={assetInstructionSet} percentages client:only="svelte" /></p>
+
+</StarlightPage>

website/src/pages/releasestats/downloads.astro

@@ -1,17 +1,12 @@
 ---
 import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
 import StackedBarChart from '../../components/newSvelte/charts/StackedBarChart.svelte';
-import StackedXBarChart from '../../components/newSvelte/charts/StackedXBarChart.svelte';
-import AssetSizeChart from '../../components/newSvelte/charts/release/AssetSizeChart.svelte';
 import { getReleaseDataArray } from '../../utils/data';
 
 const dataArray = await getReleaseDataArray();
 
 const downloads = dataArray.total_downloads_per_version_by_os();
 const downloadsPercentages = dataArray.total_downloads_per_version_by_os_as_percentages();
-
-const assetTypes = dataArray.get_asset_type_percentages();
-const assetSize = dataArray.get_asset_size_by_version();
 ---
 
 <StarlightPage
@@ -21,10 +16,25 @@ const assetSize = dataArray.get_asset_size_by_version();
 	}}
 	headings={[]}
 >
-	<StackedBarChart dataPoints={downloads} xLabel="Version Number" yLabel="Downloads" skewLabels client:only="svelte" />
-	<StackedBarChart dataPoints={downloadsPercentages} xLabel="Version Number" yLabel="Downloads" skewLabels percentages client:only="svelte" />
-	<StackedXBarChart dataPoints={assetTypes} percentages client:only="svelte" />
-	<!-- <StackedBarChart dataPoints={assetSize} xLabel="Version Number" yLabel="Asset Size" skewLabels client:only="svelte" /> -->
-	<AssetSizeChart dataPoints={assetSize} client:only="svelte" />
+	<p>
+		This page presents download statistics for Obsidian releases, including the total number of downloads per version and the distribution of downloads across different operating systems.
+	</p>
+
+	<p>
+		The download stats are inferred from publicly available GitHub release data. 
+		This data does not include mobile or insider releases. Older versions of Obsidian (pre 0.6.4) are also not included in the data.
+		The charts exclude the <code>.asar.gz</code> assets, which are used for in-app updates on all operating systems.
+	</p>
+
+	<p>
+		The below graph depicts the total number of downloads for every release, split by OS.
+	</p>
+
+	<p><StackedBarChart dataPoints={downloads} xLabel="Version Number" yLabel="Downloads" skewLabels client:only="svelte" /></p>
+	
+	<p>
+		This graph shows the distribution of downloads among the different operating systems.
+	</p>
 
+	<p><StackedBarChart dataPoints={downloadsPercentages} xLabel="Version Number" yLabel="Downloads" skewLabels percentages client:only="svelte" /></p>
 </StarlightPage>