Updated comments on plugin route table registration

Author: hugithordarson

ng-appserver/src/main/java/ng/appserver/NGApplication.java

@@ -270,24 +270,26 @@ private void loadPlugin( NGPlugin plugin ) {
 			elementManager().registerElementProvider( elementProvider );
 		}
 
-		// Obtain all the routes generated by the given plugin
+		// Check if the plugin is providing routes
 		final List<Route> routeList = plugin._createRouteList();
 
 		if( !routeList.isEmpty() ) {
 
 			// CHECKME: We generate a new route table. This is only so we can copy in the plugin's namespace. Should reeeaally happen in the plugin itself...
-			final NGRouteTable pluginRouteTable;
+			final NGRouteTable routeTable;
 
-			// If we're in development mode, the create the route table, using the plugin as a "route supplier". This means the route list gets updated, every time the user makes a change.
-			// In production, we just create the route table from a static list in instead, to maintain performance
+			// If we're in development mode, we create the route table using the plugin as a "route supplier". This means the route list gets updated, every time the user makes a change.
+			// In production, we just create the route table by reading the route list once directly, maintaining performance in production.
+			// FIXME: Whether or not the route list is cached should be configurable. It should even be configurable for each table, since some lists will rarely change (including ng's own routes) // Hugi 2025-04-19
 			if( isDevelopmentMode() ) {
-				pluginRouteTable = new NGRouteTable( plugin.namespace(), plugin::_createRouteList );
+				routeTable = new NGRouteTable( plugin.namespace(), plugin::_createRouteList );
 			}
 			else {
-				pluginRouteTable = new NGRouteTable( plugin.namespace(), plugin._createRouteList() );
+				routeTable = new NGRouteTable( plugin.namespace(), plugin._createRouteList() );
 			}
 
-			_routeTables.add( 0, pluginRouteTable );
+			// The new route table is added at the front, corresponding with the load order of the plugins
+			_routeTables.add( 0, routeTable );
 		}
 
 		plugin.load( this );

ng-control/src/main/java/ng/control/NGControlPlugin.java

@@ -33,14 +33,14 @@ public Elements elements() {
 	//	@Override
 	//	public Routes routes() {
 	//		return Routes
-	//				.map( "/home", context -> new NGResponse( "You're home", 200 ) )
-	//				.mapComponent( "/home/user", NGUserDetailPage.class );
-	//	}
-	//	@Override
-	//	public Routes routes() {
-	//		return Routes
-	//				.map( "/home", context -> new NGResponse( "You're home", 200 ) )
-	//				.mapComponent( "/home/user", NGUserDetailPage.class );
+	//				.map( "/home", request -> new NGResponse( "You're home", 200 ) )
+	//				.map( "/home/user", NGUserDetailPage.class )
+	//				.map( "/some/page", request -> {
+	//					String someValue = request.formValueForKey( "someValue" );
+	//					SomePage page = request.context().pageWithName( SomePage.class );
+	//					page.someValue = someValue;
+	//					return page;
+	//				}
 	//	}
 	//
 	//	/**