feat: add educational comments to api endpoints

Author: VariableVic

src/app/api/collections/[handle]/route.ts

@@ -4,6 +4,11 @@ import { ProductCollectionDTO } from "@medusajs/types/dist/product"
 import { notFound } from "next/navigation"
 import getPrices from "@lib/util/get-product-prices"
 
+/**
+ * This endpoint uses the serverless Product Module to retrieve a collection and its products by handle.
+ * The module connects directly to you Medusa database to retrieve and manipulate data, without the need for a dedicated server.
+ * Read more about the Product Module here: https://docs.medusajs.com/modules/products/serverless-module
+ */
 export async function GET(
   request: NextRequest,
   { params }: { params: Record<string, any> }

src/app/api/collections/route.ts

@@ -2,6 +2,11 @@ import { NextRequest, NextResponse } from "next/server"
 import { initialize as initializeProductModule } from "@medusajs/product"
 import { notFound } from "next/navigation"
 
+/**
+ * This endpoint uses the serverless Product Module to list and count all product collections.
+ * The module connects directly to you Medusa database to retrieve and manipulate data, without the need for a dedicated server.
+ * Read more about the Product Module here: https://docs.medusajs.com/modules/products/serverless-module
+ */
 export async function GET(request: NextRequest) {
   const productService = await initializeProductModule()
 

src/app/api/products/[handle]/route.ts

@@ -3,6 +3,11 @@ import getPrices from "@lib/util/get-product-prices"
 
 import { initialize as initializeProductModule } from "@medusajs/product"
 
+/**
+ * This endpoint uses the serverless Product Module to retrieve a product by handle.
+ * The module connects directly to you Medusa database to retrieve and manipulate data, without the need for a dedicated server.
+ * Read more about the Product Module here: https://docs.medusajs.com/modules/products/serverless-module
+ */
 export async function GET(
   request: NextRequest,
   { params }: { params: Record<string, any> }

src/app/api/products/route.ts

@@ -8,6 +8,11 @@ import {
 } from "@medusajs/types/dist/product/common"
 import { notFound } from "next/navigation"
 
+/**
+ * This endpoint uses the serverless Product Module to retrieve a list of products.
+ * The module connects directly to you Medusa database to retrieve and manipulate data, without the need for a dedicated server.
+ * Read more about the Product Module here: https://docs.medusajs.com/modules/products/serverless-module
+ */
 export async function GET(request: NextRequest) {
   const queryParams = Object.fromEntries(request.nextUrl.searchParams)