docs: improve locales, timezones, homepage, and fix Aside syntax

- Add intro paragraphs and usage examples to locales.md and timezones.md
- Promote locale list items from - bullets to ### headings for TOC support
- Fix homepage hero to use Astro local image asset instead of raw HTML
- Fix action and API links to remove trailing slash
- Replace VitePress :::tip[...] syntax with Starlight <Aside> component

Author: knowledgecode

docs/guide/installation.mdx

@@ -2,7 +2,7 @@
 title: Installation
 ---
 
-import { Tabs, TabItem } from '@astrojs/starlight/components';
+import { Aside, Tabs, TabItem } from '@astrojs/starlight/components';
 
 Get started with date-and-time in your project using your preferred package manager.
 
@@ -144,9 +144,9 @@ For browser-only projects, you can use date-and-time directly from a CDN:
 
 ## Bundle Size
 
-:::tip[Tree Shaking Benefits]
-date-and-time is built with tree-shaking in mind. You only bundle the functions and locales you actually use, resulting in optimal bundle sizes. Modern bundlers like Webpack 5, Rollup, and Vite automatically eliminate unused code, ensuring your application stays lightweight.
-:::
+<Aside type="tip" title="Tree Shaking Benefits">
+  date-and-time is built with tree-shaking in mind. You only bundle the functions and locales you actually use, resulting in optimal bundle sizes. Modern bundlers like Webpack 5, Rollup, and Vite automatically eliminate unused code, ensuring your application stays lightweight.
+</Aside>
 
 ## Verification
 

docs/index.mdx

@@ -3,17 +3,18 @@ title: date-and-time
 description: The simplest, most intuitive date and time library
 template: splash
 hero:
-  title: date-and-time
-  tagline: The simplest, most intuitive date and time library. Modern TypeScript library for date manipulation with full ES Modules support.
+  title: The simplest, most intuitive date and time library
+  tagline: Modern TypeScript library for date manipulation with full ES Modules support.
   image:
-    html: '<img src="/date-and-time/logo.png" alt="date-and-time" style="max-height:16rem;width:auto;" />'
+    alt: date-and-time
+    file: ./assets/logo.png
   actions:
     - text: Get Started
-      link: /date-and-time/guide/
+      link: /date-and-time/guide
       icon: right-arrow
       variant: primary
     - text: API Reference
-      link: /date-and-time/api/
+      link: /date-and-time/api
       variant: minimal
     - text: View on GitHub
       link: https://github.com/knowledgecode/date-and-time

docs/locales.md

@@ -1,250 +1,267 @@
 ---
-title: Supported Locales
+title: Locales
 ---
 
-# Supported Locales
+Locales customize the language-specific strings used in date formatting and parsing — month names, day-of-week names, and AM/PM indicators. By default, the library uses English (`en`). To use another language, import the corresponding locale module and pass it as the `locale` option.
 
-- ar (Arabic)
+```typescript
+import { format, parse } from 'date-and-time';
+import es from 'date-and-time/locales/es';
+
+const date = new Date('2025-08-23T12:00:00');
+
+format(date, 'MMMM D, YYYY', { locale: es });
+// => agosto 23, 2025
+
+format(date, 'ddd, D MMM', { locale: es });
+// => sáb, 23 ago
+```
+
+## Supported Locales
+
+The following 41 locales are available:
+
+### ar (Arabic)
 
 ```typescript
 import ar from 'date-and-time/locales/ar';
 ```
 
-- az (Azerbaijani)
+### az (Azerbaijani)
 
 ```typescript
 import az from 'date-and-time/locales/az';
 ```
 
-- bn (Bengali)
+### bn (Bengali)
 
 ```typescript
 import bn from 'date-and-time/locales/bn';
 ```
 
-- cs (Czech)
+### cs (Czech)
 
 ```typescript
 import cs from 'date-and-time/locales/cs';
 ```
 
-- da (Danish)
+### da (Danish)
 
 ```typescript
 import da from 'date-and-time/locales/da';
 ```
 
-- de (German)
+### de (German)
 
 ```typescript
 import de from 'date-and-time/locales/de';
 ```
 
-- el (Greek)
+### el (Greek)
 
 ```typescript
 import el from 'date-and-time/locales/el';
 ```
 
-- en (English)
+### en (English)
 
 ```typescript
 import en from 'date-and-time/locales/en';
 ```
 
-- es (Spanish)
+### es (Spanish)
 
 ```typescript
 import es from 'date-and-time/locales/es';
 ```
 
-- fa (Persian)
+### fa (Persian)
 
 ```typescript
 import fa from 'date-and-time/locales/fa';
 ```
 
-- fi (Finnish)
+### fi (Finnish)
 
 ```typescript
 import fi from 'date-and-time/locales/fi';
 ```
 
-- fr (French)
+### fr (French)
 
 ```typescript
 import fr from 'date-and-time/locales/fr';
 ```
 
-- he (Hebrew)
+### he (Hebrew)
 
 ```typescript
 import he from 'date-and-time/locales/he';
 ```
 
-- hi (Hindi)
+### hi (Hindi)
 
 ```typescript
 import hi from 'date-and-time/locales/hi';
 ```
 
-- hu (Hungarian)
+### hu (Hungarian)
 
 ```typescript
 import hu from 'date-and-time/locales/hu';
 ```
 
-- id (Indonesian)
+### id (Indonesian)
 
 ```typescript
 import id from 'date-and-time/locales/id';
 ```
 
-- it (Italian)
+### it (Italian)
 
 ```typescript
 import it from 'date-and-time/locales/it';
 ```
 
-- ja (Japanese)
+### ja (Japanese)
 
 ```typescript
 import ja from 'date-and-time/locales/ja';
 ```
 
-- ko (Korean)
+### ko (Korean)
 
 ```typescript
 import ko from 'date-and-time/locales/ko';
 ```
 
-- ms (Malay)
+### ms (Malay)
 
 ```typescript
 import ms from 'date-and-time/locales/ms';
 ```
 
-- my (Burmese)
+### my (Burmese)
 
 ```typescript
 import my from 'date-and-time/locales/my';
 ```
 
-- nl (Dutch)
+### nl (Dutch)
 
 ```typescript
 import nl from 'date-and-time/locales/nl';
 ```
 
-- no (Norwegian)
+### no (Norwegian)
 
 ```typescript
 import no from 'date-and-time/locales/no';
 ```
 
-- pl (Polish)
+### pl (Polish)
 
 ```typescript
 import pl from 'date-and-time/locales/pl';
 ```
 
-- pt-BR (Brazilian Portuguese)
+### pt-BR (Brazilian Portuguese)
 
 ```typescript
 import ptBR from 'date-and-time/locales/pt-BR';
 ```
 
-- pt-PT (European Portuguese)
+### pt-PT (European Portuguese)
 
 ```typescript
 import ptPT from 'date-and-time/locales/pt-PT';
 ```
 
-- ro (Romanian)
+### ro (Romanian)
 
 ```typescript
 import ro from 'date-and-time/locales/ro';
 ```
 
-- ru (Russian)
+### ru (Russian)
 
 ```typescript
 import ru from 'date-and-time/locales/ru';
 ```
 
-- rw (Kinyarwanda)
+### rw (Kinyarwanda)
 
 ```typescript
 import rw from 'date-and-time/locales/rw';
 ```
 
-- sr-Cyrl (Serbian Cyrillic)
+### sr-Cyrl (Serbian Cyrillic)
 
 ```typescript
 import srCyrl from 'date-and-time/locales/sr-Cyrl';
 ```
 
-- sr-Latn (Serbian Latin)
+### sr-Latn (Serbian Latin)
 
 ```typescript
 import srLatn from 'date-and-time/locales/sr-Latn';
 ```
 
-- sv (Swedish)
+### sv (Swedish)
 
 ```typescript
 import sv from 'date-and-time/locales/sv';
 ```
 
-- ta (Tamil)
+### ta (Tamil)
 
 ```typescript
 import ta from 'date-and-time/locales/ta';
 ```
 
-- th (Thai)
+### th (Thai)
 
 ```typescript
 import th from 'date-and-time/locales/th';
 ```
 
-- tr (Turkish)
+### tr (Turkish)
 
 ```typescript
 import tr from 'date-and-time/locales/tr';
 ```
 
-- uk (Ukrainian)
+### uk (Ukrainian)
 
 ```typescript
 import uk from 'date-and-time/locales/uk';
 ```
 
-- uz-Cyrl (Uzbek Cyrillic)
+### uz-Cyrl (Uzbek Cyrillic)
 
 ```typescript
 import uzCyrl from 'date-and-time/locales/uz-Cyrl';
 ```
 
-- uz-Latn (Uzbek Latin)
+### uz-Latn (Uzbek Latin)
 
 ```typescript
 import uzLatn from 'date-and-time/locales/uz-Latn';
 ```
 
-- vi (Vietnamese)
+### vi (Vietnamese)
 
 ```typescript
 import vi from 'date-and-time/locales/vi';
 ```
 
-- zh-Hans (Simplified Chinese)
+### zh-Hans (Simplified Chinese)
 
 ```typescript
 import zhHans from 'date-and-time/locales/zh-Hans';
 ```
 
-- zh-Hant (Traditional Chinese)
+### zh-Hant (Traditional Chinese)
 
 ```typescript
 import zhHant from 'date-and-time/locales/zh-Hant';

docs/timezones.md

@@ -1,8 +1,17 @@
 ---
-title: Supported Timezones
+title: Timezones
 ---
 
-# Supported Timezones
+Timezone support lets you format and parse dates in any timezone, regardless of the local system timezone. Pass an IANA timezone name string as the `timeZone` option to any function that accepts it — no additional imports are needed for the recommended approach.
+
+```typescript
+import { format } from 'date-and-time';
+
+const date = new Date();
+
+format(date, 'YYYY-MM-DD HH:mm:ss', { timeZone: 'Asia/Tokyo' });
+// => 2025-08-23 23:30:45
+```
 
 ## Import Methods
 
@@ -69,6 +78,8 @@ format(date, 'YYYY-MM-DD HH:mm:ss', { timeZone: New_York });
 
 ## Regions
 
+The timezones listed below are confirmed to work — since this library internally relies on the `Intl` API, other timezones supported by your runtime may also work.
+
 1. [Africa](#africa)
 2. [America](#america)
 3. [Antarctica](#antarctica)