| What do you all think?
...Oh, let me explain....
There is documentation for WOLips scattered in the Wonder wiki, the WOLips wiki, (WebObjects wiki?) etc.
Why? Would it be a good idea to have it in one place/wiki? And then refer with those fancy hyperlink things to that one place? It would seem to me that would make updating it and finding it easier. It would seem that the natural place would be in the WOLips wiki. I can see how having it spread around makes extra documentation work and difficulties.
Also, everything changes, but maybe the documentation can be set up to deal with the changes better. For example, a writer could refer to the "current version" throughout a document and maybe a note at the top would say "the current recommended version is 4.5 (July 2014)" and so on. Updating the document often would just be changing the 4.5 to 4.6, the date, July 2014 to March 2015, etc. Anything to help keep the documentation easy to update and provide clues as to what year the documentation was written.
It is too bad we don't have IBM's Watson computer to read the mailing list, extract the juicy bits, assemble a rough draft of documentation, and email it to somebody for proof reading, probably to a "Dave". Next decade?
On Jul 17, 2012, at 5:19 PM, G Brown wrote: There is also:
Getting Started The easiest way to install WOLips is to follow the steps in the Install WOLips with Eclipse Update Manager tutorial. If this is your first time using WOLips, this is the recommended method for installing WOLips.
Also the installer should have a list of materials, or a page telling what all it does.
On Jul 17, 2012, at 12:46 PM, Pascal Robert wrote: I do agree that we need to have an installer that will install Eclipse, WOLips, Wonder and the core WO frameworks. But we did cleanup the wiki a lot a couple of months ago, so I would like to know which pages on the wiki you followed, because this page:
http://wiki.wocommunity.org/display/WONDER/Project+Wonder+Installation
does specify that Java is not installed by default on Lion and launching a Java app will install the JVM.
G Brown
|