Based on the previous discussions, I have created empty pages for a Developer Guide and an Extension Developer Guide, (User Guide has been already created). http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Documentation
There was some current existing documents that were listed as children of the User guide, I moved their links to the developers guide. Specifically, the links to Tuscany Architecture Guide and the Setting up an "SCA Developer" environment were moved to the Developer Guide. Let me know if this is not correct. I would like to start to work on the user guide since I have a fresh mind (no Tuscany experience). As mentioned before, I welcome any help that I can get... Thank you to Simon and Dan who have already stepped up to this initiative. I guess I'll start with a quick verification of the download instructions. On 2/15/07, Ole Ersoy <[EMAIL PROTECTED]> wrote:
Hi, I'm working one some Maven plugins for automatically producing Eclipse Documentation Plugins that have an EMF (Could be pure documentation model) as a source. The first guide I will be automating the production of is this Apache Directory Contributor Guide: https://svn.apache.org/repos/asf/directory/sandbox/oersoy/guides/org.apache.directory.contributor.guide/org.apache.directory.doc.contributor.1.0.0.v200701091241.zip This enables us to go between the Eclipse info center and website documentation transparently. I should have the first plugin done today, in case anyone is interested. The Apache Directory Contributor Guide should also be suitable for Tusancy I would think, with a few changes to the source xml content. Cheers, - Ole --- haleh mahbod <[EMAIL PROTECTED]> wrote: > Tom, > Thanks for helping to move Tuscany website content > to CWIKI. I like the the > left navigation bar. > We could use this opportunity to simplify the site > and make it more user > friendly. For example, we might want to re-think the > way we handle languages > and put some thought into how to highlight scripting > languages. First step > will be to move the data and then we can re-arrange > a lot of this to make it > more readable. I'll work on the simplification of > the presentation in > parallel with what you are doing. I'll probably do a > mock up on another page > and move it once everyone agrees to it. > Haleh > > On 2/14/07, Dan Murphy <[EMAIL PROTECTED]> > wrote: > > > > I like the idea of having a side navigator; a > little concerned of the > > potential maintenance overhead of this on each > wiki page that needs a > > navigator (although I guess it isn't needed on > every page ?), but we'll > > only > > find out once we have a reasonable body of work, > so I'll go with Simon's > > "give it a spin and see how it goes" > > > > There is/was also a thread about wiki versus web > site @ > > > http://www.mail-archive.com/[email protected]/msg12431.html > which > > I'm not sure reached any conclusion about what > content (if any) should > > remain on the web site and what should move to the > wiki.... It seems a > > shame > > to loose the Tuscany L&F; perhaps the number of > people who have offered to > > help with the wiki based documentation outweighs > the value of the Tuscany > > L&F - it's not like the cwiki is ugly :) > > > > On 14/02/07, Simon Laws > <[EMAIL PROTECTED]> wrote: > > > > > > On 2/13/07, Jean-Sebastien Delfino > <[EMAIL PROTECTED]> wrote: > > > > > > > > [snip] > > > > Tom Seelbach wrote: > > > > > If the wiki was switched to a "left menu > theme" it would probably > > > > > apply to the whole space. > > > > > That would not work well for Tuscany since > it has 3 separate > > projects > > > > > (sca, sdo, das) as well as 2 implementations > (java, cpp). > > > > > i.e. the site is very complicated and it > wouldn't be worth it to > > carry > > > > > that left menu everywhere. There is always > the > > > > > horizontal link navigation at the top of > every page anyway so a user > > > > > is only one click from the top page. > > > > > > > > > > I just added a left-hand-nav to the wiki > homepage to serve as a > > TOC. > > > > > It's pretty simple. > > > > > I tried to follow the existing Tuscany home > as much as possible, and > > > > > link to new information on the wiki as well. > > > > > If the team agrees with this approach, we > can migrate useful > > > > > information off of the existing homepage > > > > > and onto the wiki. If the team doesn't > think this is the way to > > go, > > > > > its a simple "undo". > > > > > > > > +1, I like it. > > > > > > > > > I'm willing to port some of the existing > pages over and update them > > in > > > > > the process if this helps. > > > > > > > > Thanks! > > > > > > > > -- > > > > Jean-Sebastien > > > > > > > > > > > > > --------------------------------------------------------------------- > > > > To unsubscribe, e-mail: > [EMAIL PROTECTED] > > > > For additional commands, e-mail: > [EMAIL PROTECTED] > > > > > > > > Hi Tom > > > > > > Sidebar looks good to me. Lets give it a spin > and see how it goes. +1 > > > > > > Simon > > > > > > ____________________________________________________________________________________ No need to miss a message. Get email on-the-go with Yahoo! Mail for Mobile. Get started. http://mobile.yahoo.com/mail --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
