HI Haleh, There isn't a 'Documentation' menu item. Thats what I am talking about getting our menus organized. Now there is a 'Guides' menu set where I think all the docs are being linked.
- Venkat On 5/25/07, haleh mahbod <[EMAIL PROTECTED]> wrote:
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 > > > > > >
