Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
[jetty-dev] Embedded Examples

I added the following page earlier today.

http://www.eclipse.org/jetty/documentation/current/embedded-examples.html

I wanted to get feedback on the general approach.  This is largely in response to the number of times I have run across people stumped on seemingly simple embedded jetty usage and their inability to find more complete examples.  I have also linked a lot of folks in stack overflow and on jetty irc directly to our embedded examples and it would be better if we could link into our docs and help people help themselves.

So...what I want to do is slurp in the file like I show above and then have a walk through section that explains some of the nuts and bolts of embedded behavior in a step by step manner.  Personally I like the approach of the walkthrough indicating the lines that the description pertains to but this has the potential to get out of date.  However I have an <important> tag at the top and I am personally comfortable with it getting out of date and having a clear notification mechanism for addressing it like this.  Also the examples do not change frequently so...

Now, the flip side is that we could just document our example files better and merge the walkthrough together with the comments in the java files, but we hit a technical limitation with the JavaParser we are using to support pulling out specific methods into the documentation.  The comments are basically chewed up :)

so...I can spend some time sorting that out but personally I rather like the approach I have here so I wanted to get some other opinions.

cheers,
jesse


--
jesse mcconnell
jesse.mcconnell@xxxxxxxxx

Back to the top