Docs Update: Docs Section 1

src/routes/(inner)/docs/colors/+page.svelte

@@ -18,7 +18,7 @@
  '[style]-success-[50-900]',
  'Used for successful or positive actions, such as a form submit alert.'
  ],
- [`<div class="${cSwatch} bg-warning-500" />`, '[style]-warning-[50-900]', 'Used for negative or harmful actions, such as errors.'],
+ [`<div class="${cSwatch} bg-warning-500" />`, '[style]-warning-[50-900]', 'Used for negative or harmful actions, such as warnings.'],
  [`<div class="${cSwatch} bg-error-500" />`, '[style]-error-[50-900]', 'May be used for errors, alerts, and invalid inputs.'],
  [`<div class="${cSwatch} bg-surface-500" />`, '[style]-surface-[50-900]', 'The base level colors, used for backgrounds.']
  ]

src/routes/(inner)/docs/generator/+page.svelte

@@ -27,7 +27,7 @@
  <h2>Importing Your Theme</h2>
  <p>
  Copy and paste your theme CSS into <code>/src/theme.postcss</code>, then import the theme into your root layout in
- <code>/src/routes/+layout.svelte</code>. Keep the order as shown.
+ <code>/src/routes/+layout.svelte</code> instead of a premade Skeleton theme. Keep the order as shown.
  </p>
  <CodeBlock
  language="ts"

src/routes/(inner)/docs/get-started/SectionInstall.svelte

@@ -30,7 +30,7 @@ cd my-skeleton-app
  {:else if $storeOnboardMethod === 'manual'}
  <!-- prettier-ignore -->
  <p>
- If you have an existing SvelteKit application, start here. Otherwise let's begin by creating a new <a href="https://kit.svelte.dev/docs/creating-a-project" target="_blank" rel="noreferrer">SvelteKit project</a>.
+ If you have an existing SvelteKit application, skip to installing the Skeleton package from NPM. Otherwise let's begin by creating a new <a href="https://kit.svelte.dev/docs/creating-a-project" target="_blank" rel="noreferrer">SvelteKit project</a>.
  </p>
  <CodeBlock
  language="console"

src/routes/(inner)/docs/get-started/SectionStylesheets.svelte

@@ -33,7 +33,7 @@
  <aside class="alert variant-ghost-warning">
  <i class="fa-solid fa-triangle-exclamation text-2xl" />
  <div class="alert-message">
- <p>The order shown is critical to ensure these work as expected. Please use care when adding or modifying these.</p>
+ <p>The order shown is critical to ensure these work as expected. Please be careful when adding or modifying these!</p>
  </div>
  </aside>
  <CodeBlock

src/routes/(inner)/docs/get-started/SectionThemes.svelte

@@ -51,7 +51,7 @@
  </TabGroup>
  {#if $storeOnboardMethod === 'cli'}
  <p>
- The CLI will automatically import your prefer preset theme in <code>src/routes/+layout.svelte</code>. You may change this at any time.
+ The CLI will automatically import your preferred preset theme in <code>src/routes/+layout.svelte</code>. You may change this at any time.
  </p>
  {:else if $storeOnboardMethod === 'manual'}
  <!-- prettier-ignore -->

src/routes/(inner)/docs/introduction/+page.svelte

@@ -20,7 +20,7 @@
  <!-- Why -->
  <section class="space-y-4">
  <p class="!text-xl">
- Skeleton utilizes Tailwind’s utility classes and design system capabilities quickly and easily create beautiful interfaces. Paired
+ Skeleton utilizes Tailwind’s utility classes and design system capabilities to quickly and easily create beautiful interfaces. Paired
  with Svelte’s powerful component architecture, Skeleton creates customized, responsive, and reactive interfaces for projects of any
  scope or scale.
  </p>
@@ -39,17 +39,18 @@
  <section class="space-y-4">
  <h2>Our Vision</h2>
  <p>
- The goal of Skeleton is to create intelligent, adaptive UI that automatically adheres to your applications unique aesthetic. Utilizing
- native browser APIs and elements, such as form elements, when possible. While also augmenting this with powerful components built to
- follow WAI-ARIA guidelines for accessibility.
+ Skeleton aims to provide a seamless user experience by creating intelligent and adaptive UI elements that automatically conform to the
+ unique aesthetic of your application. It leverages native browser APIs and form elements, while also incorporating powerful components
+ that follow WAI-ARIA guidelines for accessibility, empowering developers to create user-centric web applications with ease.
  </p>
  <p>
  We're huge fans of Svelte and wish to contribute to this amazing ecosystem. We believe this only happens through contributions of high
  quality open source projects our own. Created by the community, for the community.
  </p>
  <p>
  Finally, we aim for inclusion, whether you're a contributor to the project, a consumer, or the end user. The Skeleton core team is not
- a faceless corporate entity, but rather a small group of individuals motivated to make accessible UI with great UX for all.
+ a faceless corporate entity, but rather a small group of individuals motivated to make accessible UI with great UX (user experience)
+ and DX (developer experience) for all.
  </p>
  </section>
 
@@ -73,16 +74,15 @@
  <h3>Theme System</h3>
  <p>
  We provide a powerful and comprehensive theme system that goes well beyond generating a color palette. Themes allow you to control
- common settings, such as border radius, and apply that universally throughout your application. Furthermore, themes are built using
- CSS variables, which makes theme simple to configure and reuse.
+ common settings, such as border radius, and apply those universally throughout your application. Furthermore, themes are built using
+ CSS variables, which makes themes simple to configure and reuse.
  </p>
  <!-- Design Tokens -->
  <h3>Design Tokens</h3>
  <p>
  A special set of CSS classes that ingest your theme settings for easy reuse throughout your design system. These are used as the
- default settings for most features within Skeleton, meaning your UI elements automatically adjust to theme adjustments. Likewise,
- these tokens are available to you, meaning you can build custom components using the same tools we do, for a truly cohesive look and
- feel.
+ default settings for most features within Skeleton, meaning your UI elements automatically adjust to theme changes. Likewise, these
+ tokens are available to you, meaning you can build custom components using the same tools we do, for a truly cohesive look and feel.
  </p>
  <!-- Release Cycle -->
  <h3>Release Cycle</h3>
@@ -107,8 +107,8 @@
  <p>
  A library of UI elements created by the creators of Tailwind CSS. This provides a huge library of turnkey HTML/CSS components.
  Currently Tailwind UI supports three options: HTML, React, and Vue. This means there's no plug and play solution for Svelte. You
- willneed to generate your own components and build your own logic around these. Tailwind UI can be directly integrated with
- Skeleton though, providing tight integration with Skeleton theme and design token systems.
+ will need to generate your own components and build your own logic around these. Tailwind UI can be directly integrated with
+ Skeleton though, providing tight integration with Skeleton's theme and design token systems.
  </p>
  <a class="btn variant-filled-secondary" href="/blog/skeleton-plus-tailwind-ui" target="_blank"> View our Integration Guide </a>
  </svelte:fragment>
@@ -122,8 +122,8 @@
  and opinionated design aesthetic and serves as a general purpose library, which means it can be used within any framework, while
  providing framework-specific variations like <a href="https://flowbite-svelte.com/" target="_blank" rel="noreferrer"
  >Flowbite Svelte</a
- >. Flowbite's HTML/CSS elements can be directly integrated with Skeleton though, providing tight integration with Skeleton theme
- and design token systems.
+ >. Flowbite's HTML/CSS elements can be directly integrated with Skeleton though, providing tight integration with Skeleton's
+ theme and design token systems.
  </p>
  <a class="btn variant-filled-secondary" href="/blog/skeleton-plus-flowbite" target="_blank"> View our Integration Guide </a>
  </svelte:fragment>
@@ -206,7 +206,8 @@
  <svelte:fragment slot="content">
  <p>
  We recommend the official <a href="https://svelte.dev/docs" target="_blank" rel="noreferrer">documentation</a> and
- <a href="https://svelte.dev/tutorial/basics" target="_blank" rel="noreferrer">tutorial</a> for Svelte. As well as the official
+ <a href="https://learn.svelte.dev/tutorial/welcome-to-svelte" target="_blank" rel="noreferrer">tutorial</a> for Svelte and
+ SvelteKit. As well as the official
  <a href="https://kit.svelte.dev/" target="_blank" rel="noreferrer">documentation</a> for SvelteKit.
  </p>
  </svelte:fragment>

src/routes/(inner)/docs/tokens/+page.svelte

@@ -43,7 +43,7 @@
  const tableBorder: TableSource = {
  head: headings,
  body: [
- ['<code>.border-token</code>', '', 'Implements your theme configured border size.'],
+ ['<code>.border-token</code>', '', 'Implements your theme\'s configured border size.'],
  ['<code>.border-[color]-[pairings]-token</code>', `${vColorsAll}<br>${vPairings}`, descPairings]
  ]
  };
@@ -64,9 +64,9 @@
  const tableText: TableSource = {
  head: headings,
  body: [
- ['<code>.font-heading-token</code>', '', 'Implements your theme configured heading text size.'],
- ['<code>.font-token</code>', '', 'Implements your theme configured base text size.'],
- ['<code>.text-token</code>', '', 'Implements your theme configured base text color.'],
+ ['<code>.font-heading-token</code>', '', 'Implements your theme\'s configured heading text size.'],
+ ['<code>.font-token</code>', '', 'Implements your theme\'s configured base text size.'],
+ ['<code>.text-token</code>', '', 'Implements your theme\'s configured base text color.'],
  ['<code>.text-on-[color]-token</code>', vColorsAll, 'Provides an accessible foreground color.'],
  ['<code>.text-[color]-[pairings]-token</code>', `${vColorsAll}<br>${vPairings}`, descPairings]
  ]
@@ -91,7 +91,7 @@
  <p class="!text-xl">
  Skeleton utilizes a simple but powerful <strong>design token</strong> system to implement theme settings in elements and components.
  These represent the defaults for most elements and components, which means they auto-adapt based on your theme with minimal configuration
- out of the box. Best of all you can use these within your custom components as well.
+ out of the box. Best of all you can use these within your custom components as well!
  </p>
  </section>
  <section class="space-y-4">
@@ -110,7 +110,7 @@
  <h2>Theme Flow</h2>
  <p>
  Below is a visualization of how Skeleton uses your theme to control your UI. We start with your theme's CSS variables, then
- construct design token classes from these, next components utilize these design token classes, then finally you construct your pages
+ construct design token classes based on these variables, next components utilize these design token classes, then finally you construct your pages
  with sets of elements and components.
  </p>
  <img