Formatting

Author: webpro

packages/docs/src/content/docs/index.mdx

@@ -33,9 +33,7 @@ import Contributors from '../../components/Contributors.astro';
 
 :::section{.badges}
 
-[![NPM Version](https://img.shields.io/npm/v/knip?color=f56e0f)](https://www.npmjs.com/package/knip)
-[![NPM Downloads](https://img.shields.io/npm/dm/knip?color=f56e0f)](https://www.npmjs.com/package/knip)
-[![GitHub Repo stars](https://img.shields.io/github/stars/webpro-nl/knip?style=flat&color=f56e0f)](https://github.com/webpro-nl/knip)
+[![NPM Version][2]][1] [![NPM Downloads][3]][1] [![GitHub Repo stars][5]][4]
 
 :::
 
@@ -47,44 +45,26 @@ import Contributors from '../../components/Contributors.astro';
 
 :::div{.sponsor}
 
-Using Knip? [You can support it!][2]
+Using Knip? [You can support it!][6]
 
 :::
 
 <CardGrid>
-  <Card title="Why?" icon="approve-check">
+  <Card title="Why use Knip?" icon="approve-check">
 
     Knip finds and fixes unused files, dependencies and exports. Use it for
     enhanced code and dependency management.
 
-    Read the full explanation: [why should I use Knip?][1]
-
   </Card>
 
-  <Card title="How?" icon="setting">
-
-    Deep analysis from fine-grained entry points based on the actual frameworks
-    and tooling in (mono)repos for accurate and actionable results.
-    Advanced features for maximum coverage:
+  <Card title="How does it work?" icon="setting">
 
-    * Custom module resolution
-    * Configuration file parsers
-    * Advanced shell script parser
-    * Built-in and custom compilers
-    * Auto-fix most issues
+    Advanced analysis starting from fine-grained entry points based on the
+    actual frameworks and tooling in (mono)repos for accurate and actionable
+    results.
 
   </Card>
-</CardGrid>
 
-## 🧡 Sponsors
-
-Eternal gratitude to the companies and people that are already supporting Knip:
-
-<Sponsors direction="row" showAll={false} />
-
-Please see [Sponsors][2] for the full list. Consider supporting the project too!
-
-<CardGrid stagger>
   <Card title="Battle-tested" icon="approve-check">
 
     Thousands of projects are already using Knip!
@@ -93,34 +73,36 @@ Please see [Sponsors][2] for the full list. Consider supporting the project too!
 
   <Card title="Plugins" icon="open-book">
 
-    Knip comes with [over 90 plugins][3] for tools and frameworks like Astro,
+    Knip comes with [over 90 plugins][7] for tools and frameworks like Astro,
     Cypress, ESLint, Jest, GitHub Actions, Next.js, Nx, Remix, Storybook,
     Svelte, Vite, Vitest, Webpack and many many more.
 
   </Card>
 
   <Card title="Playground" icon="rocket">
 
-    Try Knip on the [playground][4].
+    Try Knip on the [playground][8].
 
   </Card>
 
   <Card title="Troubleshooting" icon="warning">
 
-    Need help? [Start troubleshooting][5].
+    Need help? [Start troubleshooting][9].
 
   </Card>
+</CardGrid>
 
-  <Card title="/'knɪp/" icon="translate">
+## 🧡 Sponsors
 
-    Knip means "(to) cut" and is pronounced with a hard "K"  🇳🇱
+Eternal gratitude to the companies and people that are already supporting Knip:
 
-  </Card>
-</CardGrid>
+<Sponsors direction="row" showAll={false} />
+
+Please see [Sponsors][6] for the full list. Consider supporting the project too!
 
 ## 🧡 Introduction video
 
-[James Shopland][6] has a great introduction and overview of Knip (thanks
+[James Shopland][10] has a great introduction and overview of Knip (thanks
 James!):
 
 <YouTube id="uhEkgWt-pUM" />
@@ -135,48 +117,52 @@ Special thanks to the wonderful people who have contributed to this project:
 
 Most recent article first:
 
-- Tom MacWright: [Knip: good software for cleaning up TypeScript tech debt][7]
+- Tom MacWright: [Knip: good software for cleaning up TypeScript tech debt][11]
   (2024-10-25)
-- [มาทำความสะอาด Project โค้ดของเราด้วย Knip กัน][8] (2024-10-22/Thai 🇹🇭)
-- Anthony Pena: [Knip: l'ultime outil pour faire le ménage dans vos projets!][9]
-  (2024-10-08/French 🇫🇷)
-- Taro: [TypeScript/JavaScriptの不要なコードを削除するツール「Knip」の紹介][10]
+- [มาทำความสะอาด Project โค้ดของเราด้วย Knip กัน][12] (2024-10-22/Thai 🇹🇭)
+- Anthony Pena: [Knip: l'ultime outil pour faire le ménage dans vos
+  projets!][13] (2024-10-08/French 🇫🇷)
+- Taro: [TypeScript/JavaScriptの不要なコードを削除するツール「Knip」の紹介][14]
   (2024-07-25/Japanese 🇯🇵)
-- Maddy Miller: [Using Knip to find dead code in a high-traffic git repo][11]
+- Maddy Miller: [Using Knip to find dead code in a high-traffic git repo][15]
   (2023-09-17)
-- Josh Goldberg: [Speeding Up Centered Part 4: Unused Code Bloat][12]
+- Josh Goldberg: [Speeding Up Centered Part 4: Unused Code Bloat][16]
   (2023-08-21)
 - Smashing Magazine: [Knip: An Automated Tool For Finding Unused Files, Exports,
-  And Dependencies][13] (2023-08-14)
+  And Dependencies][17] (2023-08-14)
 - Effective TypeScript: [Recommendation Update: ✂️ Use knip to detect dead code
-  and types][14] (2023-07-29)
+  and types][18] (2023-07-29)
 
 ## 🧡 Testimonials
 
 <Posts />
 
 ## Read More
 
-- [Unused dependencies][15]
-- [Unused exports][16]
-
-[1]: ./explanations/why-use-knip.md
-[2]: ./sponsors
-[3]: ./reference/plugins.md
-[4]: ./playground
-[5]: ./guides/troubleshooting.md
-[6]: https://www.jamesshopland.com
-[7]: https://macwright.com/2024/10/25/good-software-knip
-[8]:
+- [Unused dependencies][19]
+- [Unused exports][20]
+
+[1]: https://www.npmjs.com/package/knip
+[2]: https://img.shields.io/npm/v/knip?color=f56e0f
+[3]: https://img.shields.io/npm/dm/knip?color=f56e0f
+[4]: https://github.com/webpro-nl/knip
+[5]: https://img.shields.io/github/stars/webpro-nl/knip?style=flat&color=f56e0f
+[6]: ./sponsors
+[7]: ./reference/plugins.md
+[8]: ./playground
+[9]: ./guides/troubleshooting.md
+[10]: https://www.jamesshopland.com
+[11]: https://macwright.com/2024/10/25/good-software-knip
+[12]:
   https://engineering.thinknet.co.th/%E0%B8%A1%E0%B8%B2%E0%B8%97%E0%B8%B3%E0%B8%84%E0%B8%A7%E0%B8%B2%E0%B8%A1%E0%B8%AA%E0%B8%B0%E0%B8%AD%E0%B8%B2%E0%B8%94-project-%E0%B9%82%E0%B8%84%E0%B9%89%E0%B8%94%E0%B8%82%E0%B8%AD%E0%B8%87%E0%B9%80%E0%B8%A3%E0%B8%B2%E0%B8%94%E0%B9%89%E0%B8%A7%E0%B8%A2-knip-%E0%B8%81%E0%B8%B1%E0%B8%99-20dbd65f6b58
-[9]:
+[13]:
   https://k49.fr.nf/knip-l-ultime-outil-pour-faire-le-menage-dans-vos-projets/
-[10]: https://tech.basemachina.jp/entry/introduction-knip
-[11]: https://madelinemiller.dev/blog/knip-dead-code/
-[12]:
+[14]: https://tech.basemachina.jp/entry/introduction-knip
+[15]: https://madelinemiller.dev/blog/knip-dead-code/
+[16]:
   https://www.joshuakgoldberg.com/blog/speeding-up-centered-part-4-unused-code-bloat/
-[13]:
+[17]:
   https://www.smashingmagazine.com/2023/08/knip-automated-tool-find-unused-files-exports-dependencies/
-[14]: https://effectivetypescript.com/2023/07/29/knip/
-[15]: ./typescript/unused-dependencies.md
-[16]: ./typescript/unused-exports.md
+[18]: https://effectivetypescript.com/2023/07/29/knip/
+[19]: ./typescript/unused-dependencies.md
+[20]: ./typescript/unused-exports.md

packages/docs/src/pages/playground.astro

@@ -3,9 +3,9 @@ import StarlightPage from '@astrojs/starlight/components/StarlightPage.astro';
 ---
 
 <StarlightPage frontmatter={{ title: 'Playground', template: 'splash' }}>
-  <p>Welcome to the Knip playground. There are issues on purpose in the codebases below so Knip will report various types of issues.</p>
+  <p>Welcome to the Knip playground. The codebases below have linting issues on purpose in the codebases, so Knip will report various types of issues.</p>
 
-  <p>Feel free to play around!</p>
+  <p>Feel free to play around! There are currently two playgrounds:</p>
 
   <ul>
     <li><a href="#basic">Basic</a></li>