Hi Venkat, I must be looking at the wrong place. I don't see documentation when I go to SCA Java. Instead I see the SDO and DAS links on the SCA java page. Am I looking at the right place?
[1]: http://cwiki.apache.org/confluence/display/TUSCANY/Java+SCA+Subproject On 5/25/07, ant elder <[EMAIL PROTECTED]> wrote:
Thanks, thats just what I needed. I've started doing this at http://cwiki.apache.org/confluence/display/TUSCANY/implementation.script Not sure about the page name, is there some format it should use that includes Java and SCA in the page name? ...ant On 5/25/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > Hi Ant, > > Ideally I'd imagine a menu item titled 'Documentation' under 'SCA Java' or > under 'Tuscany SCA'. Clicking on this will open up a page that lists all > the documentations under SCA Java. One of the links in that list will > probably be 'Tuscany Architecture and Programming Model'. Clicking this > will open a page that will have some introductory content and then a list > of > links to various aspects of the architecture and prog. model. One of the > the links would be 'Tuscany Script Implementation Extension'. > > So the trail would be Tuscany SCA->SCA Java->Documentation->Tuscany > Archp->Tuscany Extensions->Tuscany Script Implementation Extension. If > you > also think the above organization is reasonable then we probably have to > creating the missing things in that trail. > > Assuming we have all that in place then we'd probably have a 'SCA Java > Menu > page' and a template page for it. Right now there is menu page for SCA > Java > but we need to whet that a bit. > > Having said all that, let me get to what you might want to do for < > implementatoin.script> for now... Right now I have created a template in > > http://cwiki.apache.org/confluence/pages/templates/listpagetemplates.action?key=TUSCANYnamed > 'Java SCA'. Just click on the 'create page from template' option and > a page with the Java SCA menu embeded will be created where you can add > the > content. > > Hope this long winding reply helps :) > > - Venkat > > On 5/25/07, ant elder <[EMAIL PROTECTED]> wrote: > > > > On 5/25/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > > > > > Hi, > > > > > > Since we now export the wiki content for our website, we need to > follow > > > some > > > guidelines from now on when adding content to the wiki. > > > > > > 1) First we need to steam line our menus to follow some scheme. for > > > example > > > have one top level menu set that has General, Tuscany SCA , SDO and > DAS > > > (as > > > we have it now). So all pages that are general will have these > options > > in > > > the navigation bar on the left. Once into SCA or SDO or DAS we could > > have > > > another set of menu options for each with probably the General always > > > tagging on so that the user can get back to Home or other generic > > things. > > > All pages falling under SCA (say) should have the same set of options > > > unless > > > we have a sub-item with SCA that gets to have lots of options and > hence > > > must > > > have its own menu - for example Java SCA. When zeroing on the menu > > > options > > > we have to make sure we only have general things there. For example > > > architecture docs, programming guides, release process docs could all > go > > > under 'Documentation' and the documentation page can provide a link to > > all > > > the documents as its first page instead of each of the docs featuring > as > > a > > > menu item. > > > > > > 2) I have created a separate hierarchy of pages for Menus. We must > not > > > hardcode or embed menus inside pages. Its good to create separate > Menu > > > Pages and then include them the various content pages. And then when > > > creating a Menu Page ensure it goes into the Menus hierarchy and does > > not > > > get mixed with content pages > > > > > > 3) Once having created a Menu Page it would be good to go over and > > create > > > a > > > template page using that menu. For this you need to go to the > > 'Template' > > > tab in the 'Browse Space' page and add a template. In the template > can > > > typically contain the section, column and the include macro for the > > Menu. > > > Once a template is created new pages can be created from this template > > and > > > these pages will readily have the menus embeded in them with just the > > page > > > content to be filled out. This will help in avoind cut/pase of menus > in > > > each > > > page. > > > > > > 4) When composing content from now on we have to use 'Heading Styles' > to > > > demarcate various portions of the content. We could use h1, h2... h5 > to > > > create a hierarchy in the content. Other than heading styles we must > > > avoid > > > other ways of creating sections in the content to show some sort of > > > hierarchy. Having the content done this way could lead to a cleaner > > > export > > > to the website using stylesheets. > > > > > > 5) I have moved a whole bunch of pages to a separate hierarchy called > > 'To > > > Be > > > Deleted'. It would good if people can take a look at them as see if > its > > > fine. Also if you find anything else that must be deleted simply make > > the > > > parent of that page as 'To Be Deleted'. We will delete all of these > > pages > > > in a few weeks. > > > > > > 6) The banner portion looks empty but for the logo in the left > end. It > > > would be good to have that space filled with something ;-) > > > > > > So thats as much I can recollect on things that I wanted to share. If > > > anybody has more to add to this you are welcome. > > > > > > Thanks > > > > > > - Venkat > > > > > > > Not sure I understand all this so probably the best way is to try to add > > something...I want to make a page documenting <implementation.script> so > i > > guess that goes in "Java SCA" somewhere and is linked to from > > http://cwiki.apache.org/confluence/display/TUSCANY/Java+SCA+Subproject , > > could you give a brief outline of how and where i should do that? > > > > ...ant > > >
