416453 Add comments to embedded MinimalServlets example

examples/embedded/src/main/java/org/eclipse/jetty/embedded/MinimalServlets.java

@@ -32,10 +32,20 @@ public class MinimalServlets
 {
     public static void main(String[] args) throws Exception
     {
+        // Create a basic jetty server object that will listen on port 8080.  Note that if you set this to port 0
+        // then a randomly available port will be assigned that you can either look in the logs for the port,
+        // or programmatically obtain it for use in test cases.
         Server server = new Server(8080);
+
+        // The ServletHandler is a dead simple way to create a context handler that is backed by an instance of a
+        // Servlet.  This handler then needs to be registered with the Server object.
         ServletHandler handler = new ServletHandler();
         server.setHandler(handler);
 
+        // Passing in the class for the servlet allows jetty to instantite an instance of that servlet and mount it
+        // on a given context path.
+
+        // !! This is a raw Servlet, not a servlet that has been configured through a web.xml or anything like that !!
         handler.addServletWithMapping(HelloServlet.class,"/*");
 
         server.start();