Updates

.vitepress/config.mts

@@ -6,10 +6,15 @@ export default defineConfig({
 	themeConfig: {
 		nav: [
 			{ text: "Home", link: "/" },
-			{ text: "Community", link: "/community" },
+			{ text: "Community", link: "project/community" },
 			{ text: "Guide", link: "/guide" },
 		],
 		sidebar: [
+			{
+				text: "Project",
+				collapsed: false,
+				items: [{ text: "Community", link: "/project/community" }],
+			},
 			{
 				text: "Guide",
 				collapsed: false,
@@ -18,6 +23,7 @@ export default defineConfig({
 					{ text: "Setup", link: "/guide/setup" },
 					{ text: "Your first component", link: "/guide/first-component" },
 					{ text: "Under the hood", link: "/guide/under-the-hood" },
+					{ text: "Attributes deep-dive", link: "/guide/attributes" },
 				],
 			},
 			{
@@ -32,8 +38,9 @@ export default defineConfig({
 						text: "Rails",
 						collapsed: false,
 						items: [
-							{ text: "Streaming", link: "/reference/rails/streaming" },
 							{ text: "Helpers", link: "/reference/rails/helpers" },
+							{ text: "Generators", link: "/reference/rails/generators" },
+							{ text: "Streaming", link: "/reference/rails/streaming" },
 						],
 					},
 				],

design/caching.md

@@ -4,7 +4,7 @@ The most expensive (performance-wise) process in Phlex is building attributes, w
 
 Phlex supports all kinds of attributes including deeply-nested hashes, arrays, sets, strings, symbols, boolean values and even custom objects. It even has special handling for `class` and `style` attributes.
 
-Attributes need to be calculated thousands of times per render. One advantage we have is attributes are always calculated the same way. The same Hash will always produce the same String of HTML.
+Attributes need to be calculated thousands of times per render. One advantage we have is attributes are always calculated the same way. The same hash will always produce the same string of HTML.
 
 This problem lends itself well to caching. If we store the result of the first calculation, we can then resuse it the next time we get the same set of attributes.
 

guide/attributes.md

@@ -0,0 +1,19 @@
+# Attributes deep dive
+
+You’ve just rebuilt 90% of Phlex so you know a thing or two about rendering attributes.
+
+## `String` and `Symbol` keys
+
+## `String` and `Symbol` values
+
+## `Array` and `Set` attributes
+
+## Nested `Hash` attributes
+
+## The `style` attribute
+
+## The `class` attribute
+
+## Custom objects as attribute values
+
+## Boolean attributes