work on guidelines

Author: taylorotwell

.ai/herd/core.blade.php

@@ -1,2 +1,4 @@
-- The site is made available by Herd, and will be available at: https?://[kebab-case-project-dir].test. Use the `get-absolute-url` tool to generate URLs for the user to ensure user satisfaction and valid URLs.
-- You must not run any commands to make the site available via HTTP(s). It is _always_ available through Herd.
+## Laravel Herd
+
+- The application is served by Laravel Herd and will be available at: https?://[kebab-case-project-dir].test. Use the `get-absolute-url` tool to generate URLs for the user to ensure valid URLs.
+- You must not run any commands to make the site available via HTTP(s). It is _always_ available through Laravel Herd.

.ai/inertia-laravel/1/core.blade.php

@@ -1,8 +1,8 @@
-## Inertia v1 Core
+## Inertia v1
 
 - Inertia v1 does _not_ come with these features. Do not recommend using these Inertia v2 features directly.
     - Polling
     - Prefetching
     - Deferred props
-    - Infinite scrolling using merging props and WhenVisible
+    - Infinite scrolling using merging props and `WhenVisible`
     - Lazy loading data on scroll

.ai/inertia-laravel/2/core.blade.php

@@ -1,13 +1,15 @@
-## Inertia v2 Core
+## Inertia v2
 
-- Make use of all Inertia features from v1 & v2
+- Make use of all Inertia features from v1 & v2. Check the documentation before making any changes to ensure we are taking the correct approach.
 
-## Inertia v2 New Features
+### Inertia v2 New Features
 
 - Polling
 - Prefetching
 - Deferred props
-- Infinite scrolling using merging props and WhenVisible
+- Infinite scrolling using merging props and `WhenVisible`
 - Lazy loading data on scroll
 
-- When using deferred props on the frontend we should add a nice empty state with pulsing / animated skeleton. Check the docs before making any changes to ensure we are approaching this in the correct way.
+### Deferred Props & Empty States
+
+- When using deferred props on the frontend, you should add a nice empty state with pulsing / animated skeleton.

.ai/inertia-laravel/core.blade.php

@@ -1,8 +1,9 @@
 ## Inertia Core
 
-- Inertia.js components should be placed in the `resources/js/Pages` directory, unless specified differently in the JS bundler (ie. vite.config.js).
+- Inertia.js components should be placed in the `resources/js/Pages` directory unless specified differently in the JS bundler (vite.config.js).
 - Use `Inertia::render()` for server-side routing instead of traditional Blade views.
-<code-snippet lang="php" name="Inertia::render example">
+
+<code-snippet lang="php" name="Inertia::render Example">
 // routes/web.php example
 Route::get('/users', function () {
     return Inertia::render('Users/Index', [