Single Product Builds (#193)

* added cross-env, simple per-product build

* Update readme with new help info

* Remove the start-product and start-product-chok as they are the same as start and start-chok

* Add note about warning on first run

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Jordan Violet <8886650+jtviolet@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: James Anderson <james.s.anderson@netwrix.com>

Author: 4 people

README.md

@@ -91,6 +91,7 @@ npm run start
 ```bash
 # Development
 npm run start                     # Start development server
+npm run start-chok                # Start development server with polling (for network drives)
 
 # Building & Testing
 npm run build                     # Full production build
@@ -100,6 +101,26 @@ npm run clear                     # Clear Docusaurus cache
 npm run serve                     # Serve production build after `npm run build`
 ```
 
+### Building/Running Specific Products
+
+You can build or run the documentation for a single product using the `DOCS_PRODUCT` environment variable:
+
+**Windows (PowerShell):**
+```powershell
+$ENV:DOCS_PRODUCT="pingcastle"
+npm run start
+```
+
+**Unix/Linux/macOS:**
+```bash
+export DOCS_PRODUCT="pingcastle"
+npm run start
+```
+
+This works with any command (`start`, `start-chok`, `build`) and speeds up development when working on a single product. Available product IDs can be found in `src/config/products.js`.
+
+*Note: you may get a warning when you first run this. This warning doesn't seem to appear again and the site worked as expected*
+
 ### Development Workflow
 
 The centralized system makes development simple:

package.json

@@ -6,7 +6,8 @@
   "scripts": {
     "docusaurus": "npx docusaurus",
     "start": "cross-env NODE_OPTIONS=--max-old-space-size=16384 CHOKIDAR_USEPOLLING=false npx docusaurus start --port=4500 --no-open",
-    "build": "NODE_OPTIONS=--max-old-space-size=16384 npx docusaurus build",
+    "start-chok": "cross-env NODE_OPTIONS=--max-old-space-size=16384 CHOKIDAR_USEPOLLING=true npx docusaurus start --port=4500 --no-open",
+    "build": "cross-env NODE_OPTIONS=--max-old-space-size=16384 npx docusaurus build",
     "swizzle": "npx docusaurus swizzle",
     "clear": "npx docusaurus clear",
     "serve": "npx serve -s build -l 8080",

src/config/products.js

@@ -704,8 +704,14 @@ export function getDefaultProduct() {
  */
 export function generateDocusaurusPlugins() {
   const plugins = [];
+  
+  // Filter products if DOCS_PRODUCT environment variable is set
+  const targetProduct = process.env.DOCS_PRODUCT;
+  const productsToProcess = targetProduct 
+    ? PRODUCTS.filter(product => product.id === targetProduct)
+    : PRODUCTS;
 
-  PRODUCTS.forEach((product) => {
+  productsToProcess.forEach((product) => {
     product.versions.forEach((version) => {
       const pluginId = generatePluginId(product.id, version.version);
       const routeBasePath = generateRouteBasePath(product.path, version.version);