Merge pull request #1013 from roboflow/docs-feedback

Action Docs Feedback

Author: yeldarby

README.md

@@ -18,7 +18,6 @@
 [![downloads](https://img.shields.io/pypi/dm/inference)](https://pypistats.org/packages/inference)
 [![docker pulls](https://img.shields.io/docker/pulls/roboflow/roboflow-inference-server-cpu)](https://hub.docker.com/u/roboflow)
 [![license](https://img.shields.io/pypi/l/inference)](https://github.com/roboflow/inference/blob/main/LICENSE.core)
-[![discord](https://img.shields.io/discord/1159501506232451173?logo=discord&label=discord&labelColor=fff&color=5865f2&link=https%3A%2F%2Fdiscord.gg%2FGbfgXGJ8Bk)](https://discord.gg/GbfgXGJ8Bk)
 
 <!-- [![huggingface](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/Roboflow/workflows) -->
 
@@ -86,42 +85,61 @@ Workflows allow you to extend simple model predictions to build computer vision
   <tr>
     <!-- Left cell (thumbnail) -->
     <td width="300" valign="top">
-      <a href="https://youtu.be/tZa-QgFn7jg">
-        <img src="https://img.youtube.com/vi/tZa-QgFn7jg/0.jpg" 
-             alt="Smart Parking with AI" width="300" />
+      <a href="https://youtu.be/aPxlImNxj5A">
+        <img src="https://img.youtube.com/vi/aPxlImNxj5A/0.jpg" 
+             alt="Self Checkout with Workflows" width="300" />
       </a>
     </td>
     <!-- Right cell (title, date, description) -->
     <td valign="middle">
       <strong>
-        <a href="https://youtu.be/tZa-QgFn7jg">Tutorial: Build a Smart Parking System</a>
+        <a href="https://youtu.be/aPxlImNxj5A">Tutorial: Build an AI-Powered Self-Serve Checkout</a>
       </strong><br />
-      <strong>Created: 27 Nov 2024</strong><br /><br />
-      Build a smart parking lot management system using Roboflow Workflows!
-      This tutorial covers license plate detection with YOLOv8, object tracking
-      with ByteTrack, and real-time notifications with a Telegram bot.
+      <strong>Created: 2 Feb 2025</strong><br /><br />
+      Make a computer vision app that identifies different pieces of hardware, calculates
+      the total cost, and records the results to a database.
     </td>
   </tr>
 
   <tr>
     <td width="300" valign="top">
-      <a href="https://youtu.be/VCbcC5OEGRU">
-        <img src="https://img.youtube.com/vi/VCbcC5OEGRU/0.jpg" 
+      <a href="https://youtu.be/r3Ke7ZEh2Qo">
+        <img src="https://img.youtube.com/vi/r3Ke7ZEh2Qo/0.jpg" 
              alt="Workflows Tutorial" width="300" />
       </a>
     </td>
     <td valign="middle">
       <strong>
-        <a href="https://youtu.be/VCbcC5OEGRU">
-          Tutorial: Build a Traffic Monitoring Application with Workflows
+        <a href="https://youtu.be/r3Ke7ZEh2Qo">
+          Tutorial: Intro to Workflows
         </a>
       </strong><br />
-      <strong>Created: 22 Oct 2024</strong><br /><br />
+      <strong>Created: 6 Jan 2025</strong><br /><br />
       Learn how to build and deploy Workflows for common use-cases like detecting
       vehicles, filtering detections, visualizing results, and calculating dwell 
       time on a live video stream.
     </td>
   </tr>
+
+  <tr>
+    <!-- Left cell (thumbnail) -->
+    <td width="300" valign="top">
+      <a href="https://youtu.be/tZa-QgFn7jg">
+        <img src="https://img.youtube.com/vi/tZa-QgFn7jg/0.jpg" 
+             alt="Smart Parking with AI" width="300" />
+      </a>
+    </td>
+    <!-- Right cell (title, date, description) -->
+    <td valign="middle">
+      <strong>
+        <a href="https://youtu.be/tZa-QgFn7jg">Tutorial: Build a Smart Parking System</a>
+      </strong><br />
+      <strong>Created: 27 Nov 2024</strong><br /><br />
+      Build a smart parking lot management system using Roboflow Workflows!
+      This tutorial covers license plate detection with YOLOv8, object tracking
+      with ByteTrack, and real-time notifications with a Telegram bot.
+    </td>
+  </tr>
 </table>
 
 ## 📟 connecting via api
@@ -242,7 +260,7 @@ Pass an optional [Roboflow API Key](https://app.roboflow.com/settings/api) to th
 platform. When running with an API Key, usage is metered according to
 Roboflow's [pricing tiers](https://roboflow.com/pricing).
 
-|                         | Open Access | With API Key |
+|                         | Open Access | With API Key (Metered) |
 |-------------------------|-------------|--------------|
 | [Pre-Trained Models](https://inference.roboflow.com/quickstart/aliases/#supported-pre-trained-models) | ✅ | ✅
 | [Foundation Models](https://inference.roboflow.com/foundation/about/) | ✅ | ✅

docs/resources.md

@@ -3,7 +3,7 @@ hide:
   - toc
 ---
 
-# Other Resources
+# More Resources
 
 <div class="grid cards" markdown>
 
@@ -15,7 +15,7 @@ hide:
     the project. It's the place to go to file issues, make feature
     requests, or contribute.
 
-    [:fontawesome-brands-github: Go to Repo](https://github.com/roboflow/inference)
+    [:fontawesome-brands-github: Go to Repo](https://github.com/roboflow/inference){:target="_blank"}
 
 - **Roboflow Docs**
 
@@ -24,30 +24,22 @@ hide:
     Roboflow's Platform docs cover using all of the complementary
     cloud-connected features to the open source Inference project.
 
-    [:fontawesome-solid-book: Go to Docs](https://docs.roboflow.com)
+    [:fontawesome-solid-book: Go to Docs](https://docs.roboflow.com){:target="_blank"}
 
 - **Roboflow Forum**
 
     ---
 
     Get help from and connect with a community of computer vision enthusiasts
 
-    [:fontawesome-regular-comment: Go to Forum](https://discuss.roboflow.com)
-
-- **Roboflow Discord**
-
-    ---
-
-    Chat with the Roboflow Community and Team
-
-    [:fontawesome-brands-discord: Go to Chat](https://discord.gg/GbfgXGJ8Bk)
+    [:fontawesome-regular-comment: Go to Forum](https://discuss.roboflow.com){:target="_blank"}
 
 - **Roboflow YouTube**
 
     ---
 
     Regular videos with computer Vision news, tutorials, product updates, and more
 
-    [:fontawesome-brands-youtube: Go to Channel](https://bit.ly/rf-yt-sub)
+    [:fontawesome-brands-youtube: Go to Channel](https://bit.ly/rf-yt-sub){:target="_blank"}
 
 </div>

docs/start/getting-started.md

@@ -81,7 +81,7 @@ as starting a Docker container.
 !!! info "Self-Hosted Pricing"
     Basic usage of self-hosted Inference Servers is completely free.
 
-    Workflows that require
+    Workflows and Models that require
     [a Roboflow API Key](https://docs.roboflow.com/api-reference/authentication#retrieve-an-api-key)
     to access Roboflow Cloud powered features (for example: the private model repository)
     are [metered and consume credits](https://roboflow.com/pricing)

docs/video-tutorials.md

@@ -1,39 +1,56 @@
 <div class="tutorial-list">
   <!-- Tutorial 1 -->
   <div class="tutorial-item">
-    <a href="https://youtu.be/tZa-QgFn7jg">
-      <img src="https://img.youtube.com/vi/tZa-QgFn7jg/0.jpg" alt="Smart Parking with AI" />
+    <a href="https://youtu.be/aPxlImNxj5A">
+      <img src="https://img.youtube.com/vi/aPxlImNxj5A/0.jpg" alt="Workflows Tutorial" />
     </a>
     <div class="tutorial-content">
-      <a href="https://youtu.be/tZa-QgFn7jg">
-        <strong>Tutorial: Build a Smart Parking System</strong>
+      <a href="https://youtu.be/aPxlImNxj5A">
+        <strong>Tutorial: Build an AI-Powered Self-Serve Checkout</strong>
       </a>
-      <div><strong>Created: 27 Nov 2024</strong></div>
+      <div><strong>Created: 2 Feb 2025</strong></div>
       <p>
-        Build a smart parking lot management system using Roboflow Workflows!
-        This tutorial covers license plate detection with YOLOv8, object tracking
-        with ByteTrack, and real-time notifications with a Telegram bot.
+        Make a computer vision app that identifies different pieces of hardware, calculates
+      the total cost, and records the results to a database.
       </p>
     </div>
   </div>
-
+  
   <!-- Tutorial 2 -->
   <div class="tutorial-item">
-    <a href="https://youtu.be/VCbcC5OEGRU">
-      <img src="https://img.youtube.com/vi/VCbcC5OEGRU/0.jpg" alt="Workflows Tutorial" />
+    <a href="https://youtu.be/r3Ke7ZEh2Qo">
+      <img src="https://img.youtube.com/vi/r3Ke7ZEh2Qo/0.jpg" alt="Workflows Tutorial" />
     </a>
     <div class="tutorial-content">
-      <a href="https://youtu.be/VCbcC5OEGRU">
-        <strong>Tutorial: Build a Traffic Monitoring Application with Workflows</strong>
+      <a href="https://youtu.be/r3Ke7ZEh2Qo">
+        <strong>Tutorial: Intro to Workflows</strong>
       </a>
-      <div><strong>Created: 22 Oct 2024</strong></div>
+      <div><strong>Created: 6 Jan 2025</strong></div>
       <p>
         Learn how to build and deploy Workflows for common use-cases like detecting 
         vehicles, filtering detections, visualizing results, and calculating dwell 
         time on a live video stream.
       </p>
     </div>
   </div>
+
+  <!-- Tutorial 3 -->
+  <div class="tutorial-item">
+    <a href="https://youtu.be/tZa-QgFn7jg">
+      <img src="https://img.youtube.com/vi/tZa-QgFn7jg/0.jpg" alt="Smart Parking with AI" />
+    </a>
+    <div class="tutorial-content">
+      <a href="https://youtu.be/tZa-QgFn7jg">
+        <strong>Tutorial: Build a Smart Parking System</strong>
+      </a>
+      <div><strong>Created: 27 Nov 2024</strong></div>
+      <p>
+        Build a smart parking lot management system using Roboflow Workflows!
+        This tutorial covers license plate detection with YOLOv8, object tracking
+        with ByteTrack, and real-time notifications with a Telegram bot.
+      </p>
+    </div>
+  </div>
 
   <!-- Add more .tutorial-item blocks as needed -->
 </div>

docs/workflows/about.md

@@ -21,13 +21,31 @@ With Workflows, you can:
 - Introduce elements of business logic to translate model predictions into your domain language
 
 <div class="button-holder">
-<a href="/workflows/blocks/" class="button half-button">Explore all Workflows blocks</a>
+<a href="/workflows/blocks/" class="button half-button">Explore all Workflow blocks</a>
 <a href="https://app.roboflow.com/workflows" class="button half-button">Begin building with Workflows</a>
 </div>
 
 ![A license plate detection workflow implemented in Workflows](https://media.roboflow.com/inference/workflow-example.png)
 
 
-In this section of documentation, we walk through what you need to know to create and run workflows. Let’s get started! 
+In this section of documentation, we walk through what you need to know to create and run workflows. Let’s get started!
 
-[Create and run a workflow.](/workflows/create_and_run.md)
+Next, [create and run a workflow](/workflows/create_and_run.md) or
+[browse example Workflows](/workflows/gallery/index.md).
+
+<style>
+.button-holder {
+  margin-bottom: 1.5rem;
+}
+
+.button {
+  background-color: var(--md-primary-fg-color);
+  display: flex;
+  padding: 10px;
+  color: white !important;
+  border-radius: 5px;
+  text-align: center;
+  align-items: center;
+  justify-content: center;
+}
+</style>

mkdocs.yml

@@ -162,7 +162,7 @@ nav:
           - Install “bare metal” Inference GPU on Windows: quickstart/inference_gpu_windows.md
       - Contribute to Inference: contributing.md
       - Changelog: https://github.com/roboflow/inference/releases
-  - Cookbooks: cookbooks.md
+  - Examples: workflows/gallery/
 
 theme:
   name: 'material'