wip

Author: hasparus

src/components/learn-aggregator/items.tsx

@@ -11,114 +11,136 @@ interface LearnPageItem {
 
 const _items: Record<LearnPagePath, Omit<LearnPageItem, "title"> | null> = {
   introduction: {
-    description: "",
-    icon: "",
+    description:
+      "Get a high-level overview of GraphQL and how it enables flexible, versionless APIs powered by a strong type system.",
+    icon: new URL("./icons/computer.svg", import.meta.url).href,
     section: "getting-started",
   },
   schema: {
-    description: "",
-    icon: "",
+    description:
+      "Learn the elements of the GraphQL type system and how schemas describe your data and relationships.",
+    icon: new URL("./icons/hierarchy.svg", import.meta.url).href,
     section: "getting-started",
   },
   queries: {
-    description: "",
-    icon: "",
+    description:
+      "Use query operations to fetch exactly the data you need from a GraphQL server.",
+    icon: new URL("./icons/search.svg", import.meta.url).href,
     section: "getting-started",
   },
   mutations: {
-    description: "",
-    icon: "",
+    description:
+      "See how mutation operations write data and when side effects are allowed in GraphQL.",
+    icon: new URL("./icons/construction.svg", import.meta.url).href,
     section: "getting-started",
   },
   subscriptions: {
-    description: "",
-    icon: "",
+    description:
+      "Get real-time updates from a GraphQL server with long-lived subscription operations.",
+    icon: new URL("./icons/sync-square.svg", import.meta.url).href,
     section: "getting-started",
   },
   validation: {
-    description: "",
-    icon: "",
+    description:
+      "Validate operations against your schema to catch issues before execution.",
+    icon: new URL("./icons/product-check.svg", import.meta.url).href,
     section: "getting-started",
   },
   execution: {
-    description: "",
-    icon: "",
+    description:
+      "Understand how GraphQL resolves fields during execution to fulfill client requests.",
+    icon: new URL("./icons/board.svg", import.meta.url).href,
     section: "getting-started",
   },
   response: {
-    description: "",
-    icon: "",
+    description:
+      "Learn how GraphQL responses mirror queries, include data, and surface errors.",
+    icon: new URL("./icons/share.svg", import.meta.url).href,
     section: "getting-started",
   },
   introspection: {
-    description: "",
-    icon: "",
+    description:
+      "Ask a schema about its types and fields using GraphQL's introspection system.",
+    icon: new URL("./icons/zoom-page.svg", import.meta.url).href,
     section: "getting-started",
   },
   // ---
   "best-practices": {
-    description: "",
-    icon: "",
+    description:
+      "Practical guidance for networking, authorization, pagination, and other everyday GraphQL concerns.",
+    icon: new URL("./icons/books.svg", import.meta.url).href,
     section: "best-practices",
   },
   "thinking-in-graphs": {
-    description: "",
-    icon: "",
+    description:
+      "Model your business domain as a graph and use schemas to express connected types.",
+    icon: new URL("./icons/layer.svg", import.meta.url).href,
     section: "best-practices",
   },
   "serving-over-http": {
-    description: "",
-    icon: "",
+    description:
+      "Follow HTTP guidelines to respond to GraphQL queries and mutations over the web.",
+    icon: new URL("./icons/globe.svg", import.meta.url).href,
     section: "best-practices",
   },
   "file-uploads": {
-    description: "",
-    icon: "",
+    description:
+      "Understand why file uploads are tricky in GraphQL and safer patterns to support them.",
+    icon: new URL("./icons/note.svg", import.meta.url).href,
     section: "best-practices",
   },
   authorization: {
-    description: "",
-    icon: "",
+    description:
+      "Design authorization in your schema to control which users can access specific data.",
+    icon: new URL("./icons/key.svg", import.meta.url).href,
     section: "best-practices",
   },
   pagination: {
-    description: "",
-    icon: "",
+    description:
+      "Paginate lists and connections so clients can traverse large graphs efficiently.",
+    icon: new URL("./icons/menu.svg", import.meta.url).href,
     section: "best-practices",
   },
   "schema-design": {
-    description: "",
-    icon: "",
+    description:
+      "Evolve schemas without versioning while keeping types clear and future-friendly.",
+    icon: new URL("./icons/cog-double.svg", import.meta.url).href,
     section: "best-practices",
   },
   "global-object-identification": {
-    description: "",
-    icon: "",
+    description:
+      "Expose global object IDs so clients can refetch, cache, and reference data reliably.",
+    icon: new URL("./icons/dna.svg", import.meta.url).href,
     section: "best-practices",
   },
   caching: {
-    description: "",
-    icon: "",
+    description:
+      "Use identifiers and response patterns that enable effective caching for GraphQL clients and servers.",
+    icon: new URL("./icons/sync-square.svg", import.meta.url).href,
     section: "best-practices",
   },
   performance: {
-    description: "",
-    icon: "",
+    description:
+      "Optimize GraphQL requests and implementations for fast, efficient performance.",
+    icon: new URL("./icons/startup.svg", import.meta.url).href,
     section: "best-practices",
   },
   security: {
-    description: "",
-    icon: "",
+    description:
+      "Protect GraphQL APIs against common attack vectors with layered security practices.",
+    icon: new URL("./icons/safe.svg", import.meta.url).href,
     section: "best-practices",
   },
   federation: {
-    description: "",
-    icon: "",
+    description:
+      "Compose multiple services into a single graph using GraphQL federation.",
+    icon: new URL("./icons/globe.svg", import.meta.url).href,
     section: "best-practices",
   },
   "debug-errors": {
-    description: "",
-    icon: "",
+    description:
+      "Identify common HTTP and GraphQL errors and debug them effectively.",
+    icon: new URL("./icons/solve.svg", import.meta.url).href,
     section: "best-practices",
   },
 }