Docs: improve searchability by naming methods

Author: skryukov

docs/guide/asset-versioning.md

@@ -4,7 +4,7 @@ One common challenge when building single-page apps is refreshing site assets wh
 
 ## Configuration
 
-To enable automatic asset refreshing, you need to tell Inertia the current version of your assets. This can be any arbitrary string (letters, numbers, or a file hash), as long as it changes when your assets have been updated.
+To enable automatic asset refreshing, you need to tell Inertia the current version of your assets using the `InertiaRails.configure` method and setting the `config.version` property. This can be any arbitrary string (letters, numbers, or a file hash), as long as it changes when your assets have been updated.
 
 ```ruby
 InertiaRails.configure do |config|

docs/guide/client-side-setup.md

@@ -32,7 +32,7 @@ npm install @inertiajs/svelte svelte
 
 ## Initialize the Inertia app
 
-Next, update your main JavaScript file to boot your Inertia app. To accomplish this, we'll initialize the client-side framework with the base Inertia component.
+Next, update your main JavaScript file to boot your Inertia app. To accomplish this, we'll use the `createInertiaApp` function to initialize the client-side framework with the base Inertia component.
 
 :::tabs key:frameworks
 == Vue

docs/guide/configuration.md

@@ -4,7 +4,7 @@ Inertia Rails can be configured globally or in a specific controller (and subcla
 
 ## Global Configuration
 
-If using global configuration, we recommend you place the code inside an initializer:
+Use the `InertiaRails.configure` method to set global configuration options. If using global configuration, we recommend you place the code inside an initializer:
 
 ```ruby
 # config/initializers/inertia.rb
@@ -19,7 +19,7 @@ The default configuration can be found [here](https://github.com/inertiajs/inert
 
 ## Local Configuration
 
-Use `inertia_config` in your controllers to override global settings:
+The `inertia_config` method allows you to override global settings in specific controllers. Use this method in your controllers to customize configuration for specific parts of your application:
 
 ```ruby
 class EventsController < ApplicationController

docs/guide/csrf-protection.md

@@ -4,7 +4,7 @@
 
 Inertia's Rails adapter automatically includes the proper CSRF token when making requests via Inertia or Axios. Therefore, **no additional configuration is required**.
 
-However, if you need to handle CSRF protection manually, one approach is to include the CSRF token as a prop on every response. You can then use the token when making Inertia requests.
+However, if you need to handle CSRF protection manually, one approach is to include the CSRF token as a prop on every response. You can then use the token when making Inertia requests with the `router.post` method.
 
 :::tabs key:frameworks
 == Vue
@@ -67,7 +67,7 @@ When a CSRF token mismatch occurs, Rails raises the `ActionController::InvalidAu
 
 Obviously, this isn't a great user experience. A better way to handle these errors is to return a redirect back to the previous page, along with a flash message that the page expired. This will result in a valid Inertia response with the flash message available as a prop which you can then display to the user. Of course, you'll need to share your [flash messages](/guide/shared-data.md#flash-messages) with Inertia for this to work.
 
-You may modify your application's exception handler to automatically redirect the user back to the page they were previously on while flashing a message to the session. To accomplish this, you may use the `rescue_from` method in your `ApplicationController`.
+You may modify your application's exception handler to automatically redirect the user back to the page they were previously on while flashing a message to the session. To accomplish this, you may use the `rescue_from` method in your `ApplicationController` to handle the `ActionController::InvalidAuthenticityToken` exception.
 
 ```ruby
 class ApplicationController < ActionController::Base

docs/guide/deferred-props.md

@@ -4,7 +4,7 @@ Inertia's deferred props feature allows you to defer the loading of certain page
 
 ## Server side
 
-To defer a prop, you can use the defer method when returning your response. This method receives a callback that returns the prop data. The callback will be executed in a separate request after the initial page render.
+To defer a prop, you can use the `InertiaRails.defer` method when returning your response. This method receives a callback that returns the prop data. The callback will be executed in a separate request after the initial page render.
 
 ```ruby
 class UsersController < ApplicationController
@@ -20,7 +20,7 @@ end
 
 ### Grouping requests
 
-By default, all deferred props get fetched in one request after the initial page is rendered, but you can choose to fetch data in parallel by grouping props together.
+By default, all deferred props get fetched in one request after the initial page is rendered, but you can choose to fetch data in parallel by grouping props together using the `group` option with the `InertiaRails.defer` method.
 
 ```ruby
 class UsersController < ApplicationController

docs/guide/forms.md

@@ -186,7 +186,7 @@ For a full discussion on handling and displaying [validation](/guide/validation.
 
 ## Form helper
 
-Since working with forms is so common, Inertia includes a form helper designed to help reduce the amount of boilerplate code needed for handling typical form submissions.
+Since working with forms is so common, Inertia includes a form helper designed to help reduce the amount of boilerplate code needed for handling typical form submissions. The `useForm` method provides a convenient way to manage form state, validation, and submission.
 
 :::tabs key:frameworks
 == Vue

docs/guide/history-encryption.md

@@ -6,7 +6,7 @@ Imagine a scenario where your user is authenticated, browses privileged informat
 
 When you instruct Inertia to encrypt your app's history, it uses the browser's built-in [`crypto` api](https://developer.mozilla.org/en-US/docs/Web/API/Crypto) to encrypt the current page's data before pushing it to the history state. We store the corresponding key in the browser's session storage. When the user navigates back to a page, we decrypt the data using the key stored in the session storage.
 
-Once you instruct Inertia to clear your history state, we simply clear the existing key from session storage roll a new one. If we attempt to decrypt the history state with the new key, it will fail an Inertia will make a fresh request back to your server for the page data.
+Once you instruct Inertia to clear your history state, we simply clear the existing key from session storage and roll out a new one. If we attempt to decrypt the history state with the new key, it will fail and Inertia will make a fresh request back to your server for the page data.
 
 > [!NOTE]
 > History encryption relies on `window.crypto.subtle` which is only available in secure environments (sites with SSL enabled).
@@ -47,12 +47,41 @@ end
 
 ## Clearing history
 
-To clear the history state, you can pass the `clear_history` option to the `render` method:
+To clear the history state on the server side, you can pass the `clear_history` option to the `render` method:
 
 ```ruby
 render inertia: 'Dashboard', props: {}, clear_history: true
 ```
 
 Once the response has rendered on the client, the encryption key will be rotated, rendering the previous history state unreadable.
 
-You can also clear history on the client site by calling `router.clearHistory()`.
+### Client-side clearing
+
+You can also clear history directly on the client side by calling the `router.clearHistory()` method:
+
+:::tabs key:frameworks
+== Vue
+
+```js
+import { router } from '@inertiajs/vue3'
+
+router.clearHistory()
+```
+
+== React
+
+```js
+import { router } from '@inertiajs/react'
+
+router.clearHistory()
+```
+
+== Svelte 4|Svelte 5
+
+```js
+import { router } from '@inertiajs/svelte'
+
+router.clearHistory()
+```
+
+:::

docs/guide/manual-visits.md

@@ -270,15 +270,14 @@ router.post('/users', {
 == Svelte 4|Svelte 5
 
 ```js
-
-```
-
 import { router } from '@inertiajs/svelte'
 
 router.post('/users', {
-name: 'John Doe',
-email: '[email protected]',
+  name: 'John Doe',
+  email: '[email protected]',
 })
+```
+
 :::
 
 ## Custom headers

docs/guide/responses.md

@@ -139,7 +139,7 @@ Inertia Rails provides a number of generators to help you get started with Inert
 
 ### Scaffold generator
 
-To create a resource with Inertia responses, execute the following command in the terminal:
+Use the `inertia:scaffold` generator to create a resource with Inertia responses. Execute the following command in the terminal:
 
 ```bash
 bin/rails generate inertia:scaffold ModelName field1:type field2:type
@@ -185,7 +185,7 @@ Inertia Rails tries to detect the presence of Tailwind CSS in the application an
 
 ### Controller generator
 
-To create a controller with an Inertia response, execute the following command in the terminal:
+Use the `inertia:controller` generator to create a controller with an Inertia response. Execute the following command in the terminal:
 
 ```bash
 bin/rails generate inertia:controller ControllerName action1 action2
@@ -211,7 +211,7 @@ $ bin/rails generate inertia:controller pages welcome next_steps
 
 ### Customizing the generator templates
 
-Rails generators allow templates customization. For example, to customize the controller generator view template, create a file `lib/templates/inertia_templates/controller/react/view.jsx.tt`:
+Rails generators allow templates customization. You can create custom template files in your application to override the default templates used by the generators. For example, to customize the controller generator view template for React, create a file at the path `lib/templates/inertia_templates/controller/react/view.jsx.tt`:
 
 ```jsx
 export default function <%= @action.camelize %>() {

docs/guide/testing.md

@@ -35,6 +35,8 @@ end
 
 ### Assertions
 
+Inertia Rails provides several RSpec matchers for testing Inertia responses. You can use methods like `expect_inertia`, `render_component`, `have_exact_props`, `include_props`, `have_exact_view_data`, and `include_view_data` to test your Inertia responses.
+
 ```ruby
 # spec/requests/events_spec.rb
 RSpec.describe '/events', inertia: true do