docs: add overview guides to specific modules (#1929)

1 files changed, 6 insertions, 0 deletions

diff --git a/src/modules/vehicle/index.ts b/src/modules/vehicle/index.ts
index 2b153c79..25308dcb 100644
--- a/src/modules/vehicle/index.ts
+++ b/src/modules/vehicle/index.ts
@@ -2,6 +2,12 @@ import type { Faker } from '../..';
 
 /**
  * Module to generate vehicle related entries.
+ *
+ * ### Overview
+ *
+ * Most methods are related to cars/automobiles: a [`vehicle()`](https://next.fakerjs.dev/api/vehicle.html#vehicle) name is comprised of a car [`manufacturer()`](https://next.fakerjs.dev/api/vehicle.html#manufacturer) and [`model()`](https://next.fakerjs.dev/api/vehicle.html#model). You can also generate [`fuel()`](https://next.fakerjs.dev/api/vehicle.html#fuel), [`type()`](https://next.fakerjs.dev/api/vehicle.html#type), and [`color()`](https://next.fakerjs.dev/api/vehicle.html#color), as well as typical car registration IDs [`vin()`](https://next.fakerjs.dev/api/vehicle.html#vin) and [`vrm()`](https://next.fakerjs.dev/api/vehicle.html#vrm).
+ *
+ * If you prefer two wheels, you can generate a [`bicycle()`](https://next.fakerjs.dev/api/vehicle.html#bicycle) type instead.
  */
 export class VehicleModule {
   constructor(private readonly faker: Faker) {