polish and improved docs

exampleSite/content/_index.md

@@ -3,9 +3,13 @@ title: "Welcome to Blowfish! :tada:"
 description: "This page was built using the Blowfish theme for Hugo."
 ---
 
-Welcome to Blowfish, one of the most flexible and robust Hugo themes. Here you can find the complete [theme documentation]({{< ref "docs" >}}). Blowfish is highly customizable and can be configured to fit your needs: from a static website to a blog. Checkout some [examples](/examples) and what some of our [users](/users) have been building.
+Welcome to Blowfish, one of the most flexible and robust Hugo themes. It is designed to be simple, fast and content-focused. Learn how to get started:
 
-Explore the [sample pages]({{< ref "samples" >}}) to get a feel for what Blowfish can do. If you like what you see, check out the project on <a target="_blank" href="https://github.com/nunocoracao/blowfish">Github</a> or read the [Installation guide]({{< ref "docs/installation" >}}) to get started.
+{{< article link="/docs/installation/" >}}
+
+You can also find the complete theme documentation in [docs]({{< ref "docs" >}}). Blowfish is highly customizable and can be configured to fit your needs: from a static website to a blog. Checkout some [examples](/examples) and what some of our [users](/users) have been building.
+
+Explore the [shortcode list]({{< ref "docs/shortcodes" >}}) and [sample pages]({{< ref "samples" >}}) to get a feel for what Blowfish can do. If you like what you see, check out the project on <a target="_blank" href="https://github.com/nunocoracao/blowfish">Github</a> or read the [Installation guide]({{< ref "docs/installation" >}}) to get started.
 
 <div class="flex px-4 py-2 mb-8 text-base rounded-md bg-primary-100 dark:bg-primary-900">
   <span class="flex items-center ltr:pr-3 rtl:pl-3 text-primary-400">

layouts/partials/article-link/simple.html

@@ -60,7 +60,7 @@
 
 
     <div class="{{ $articleInnerClasses }}">
-      <div class="items-center text-xl font-semibold">
+      <div class="items-center text-left text-xl font-semibold">
         {{ with .Params.externalUrl }}
         <div>
           <div