Hi Ant, What drove that statement was the re-org that had to done to the content. If we do not follow some fundamental guidelines its going to be difficult to organize or link up the content. Also there aren't any guidelines there that are going to be cumbersome to follow - there are just about simple things like taking care to see that a page aligns with the overall page tree structure and that it has a consistent set of menus... For this release there has been quite a bit of effort that had to be spent just to reorganize the contents.
If there is any guideline that you feel could be cumbersome I am open to making it simple to encourage contributions. Thanks - Venkat On 6/5/07, ant elder <[EMAIL PROTECTED]> wrote:
I don't like this bit: "Since the Wiki content forms the backbone for the public website content, it is important that the community adheres to some community accepted common guidelines when authoring content on the Wiki, to help in consistency and maintainability of the content." If we're worried about what happens on the website we should just restrict access so only committers can update it, then, just as with the code, we work CTR. The website is looking good now, much better than before, but IMHO that doesn't mean its perfect or that we should try to restrict or control any future changes to it. ...ant On 6/5/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > Hi, > > I've added more to this guidelines page. Please take a look and see if it > all makes sense. Thanks. > > - Venkat > > On 6/5/07, haleh mahbod <[EMAIL PROTECTED]> wrote: > > > > Hi, > > > > Website update is done. > > > > Below is the draft of 'cwiki development guide' that lays out the tree > > structure for cwiki. > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+cwiki+Development+Guideline > > Can we update it with your suggestions and once an agreement is reached > > make > > it the development guide for cwiki. > > It was very difficult to organize the content and I am sure it'll get > into > > the same shape if we don't all follow some agreed to guidelines. > > > > > > Work remaining: > > - Convert the old download pages to the new format. Thanks Venkat for > your > > help thus far for moving the content from the old style to the new > style. > > - There is a lot of in-progress documentation. Are any of these ready to > > be > > added to the list of documentations for each project? > > > > Haleh > > > > On 6/2/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > > > > > Hi Haleh, please see my comments inline. > > > > > > Thanks > > > > > > - Venkat > > > > > > On 6/1/07, haleh mahbod <[EMAIL PROTECTED]> wrote: > > > > > > > > I don't see a difference and in fact it is more work. > > > > > > > > In today's mode: you update one page. > > > > a) update Latest release > > > > b) move the old release to previous releases. > > > > (Note: I think previous releases should be on the same page). > > > > > > > > > For every release I suppose we will have alteast 1 or 1.5 pages of > > > information i.e. the release related info and the two tables. Do you > > mean > > > we move all of this to the 'Previous Release' section. If we did this > > by > > > the end of this year we will have several pages to scroll down to. > > > > > > In your proposal: Have a page for each release and then link it back > to > > > > latest releases page. > > > > > > > > > Yes.. the pages are short and concise. There is just about a list of > > > releases and the user can choose any one and then get to read up what > > the > > > release contains and what is downloadable on a diff. pages. This is > not > > > much overhead - what is more is just a couple of lines. > > > > > > Are we making this too complicated? My preference would be to convert > > the > > > > table we currently have into something readable > > > > that has a link to readme for the release on the same page. I'll add > a > > > > sample to the page so we can take a look. > > > > > > > > On 6/1/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > > > > > > > > > Hi Haleh, > > > > > > > > > > I am trying to re-org the downloads / release page for the > following > > > > > reason > > > > > :-- > > > > > > > > > > Currently the SCA Release pages points to two things i) Latest > > Release > > > > ii) > > > > > Previous Releases. In the Latest Release section we have > hardcoded > > > the > > > > > content for the 0.90 release. This is something we will have to > > > revisit > > > > > every time we make a release and then the content there has to be > > > moved > > > > > over > > > > > as well. i.e. for 0.91 we will have to edit this page and then > move > > > the > > > > > contents of 0.90 else where. To help this to be a bit smooth, I > > > suggest > > > > > that for every release we create a separate page i.e. a page for > > 0.90, > > > a > > > > > page for 0.91 and so on. Then in the SCA Releases page we simply > > > > > 'inlcude' > > > > > the relevant page under the 'Latest Release' section. > > > > > > > > > > For the section on Previous Releases, I suggest that we put up a > > > > > table/list > > > > > of links to all the previous release pages. So when there is 0.91 > , > > we > > > > > simply include 0.91 page to the 'Latest Release' section and then > > > > include > > > > > ' > > > > > 0.90' page to the 'Previous Releases' list. > > > > > > > > > > I feel this is maintainable in the long run. Hope I am no missing > > > > > something > > > > > in all of this > > > > > > > > > > - Venkat > > > > > > > > > > On 6/1/07, Venkata Krishnan <[EMAIL PROTECTED]> wrote: > > > > > > > > > > > > Hi Kelvin, I've just added one more menu item 'SCA Java Home' to > > > link > > > > > > back to the home page of the subproject. Will do the same for > DAS > > > and > > > > > SDO > > > > > > as well, now. > > > > > > > > > > > > Also I am going to see if we can get the other downloads pages > (M2 > > > > ones) > > > > > > to look the same as the current one. > > > > > > > > > > > > - Venkat > > > > > > > > > > > > On 6/1/07, kelvin goodson <[EMAIL PROTECTED]> wrote: > > > > > > > > > > > > > > Haleh, > > > > > > > this looks really good, thanks. I particularly like the > > "Latest > > > > > > > Tuscany > > > > > > > Releases" inset box and the new download page layout. The > > > > sub-project > > > > > > > menu > > > > > > > doesn't provide a link back to the sub-project's home. Would > it > > be > > > > > > > possible > > > > > > > to make the title of the sub-project menu to be a link back to > > the > > > > > > > sub-project's home? > > > > > > > > > > > > > > Regards, Kelvin. > > > > > > > > > > > > > > On 01/06/07, haleh mahbod <[EMAIL PROTECTED]> wrote: > > > > > > > > > > > > > > > > Hi, > > > > > > > > The left navigation bar used to change as we navigated > through > > > > > pages. > > > > > > > > We also had a discussion around wanting a release page per > > > > > subproject > > > > > > > on > > > > > > > > the > > > > > > > > subproject page. > > > > > > > > Based on these comments, I have made the following updates > for > > > SCA > > > > > > > Java > > > > > > > > for > > > > > > > > now. If it looks good, > > > > > > > > I'll go ahead and make the updates for other subprojects. > > > > > > > > > > > > > > > > - Left Menu remains consistent for Home page and Overview > > pages > > > > for > > > > > > > all > > > > > > > > subprojects. Home and Overview pages are considered Tuscany > > > > General > > > > > > > pages. > > > > > > > > Example: The following pages have the same navigation on > the > > > > left. > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/Home > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Overview > > > > > > > > > > > > > > > > - The general information on the home page applies to the > > whole > > > > > > > Tuscany. > > > > > > > > Here you will find a link to all Tuscany Documentations and > > > > > Downloads. > > > > > > > > > > > > > > > > - Once you enter a subproject page, the left menu remains > > > > consistent > > > > > > > as > > > > > > > > you > > > > > > > > navigate through the information related to the subproject. > > > > > > > > Example: > > > > > > > > > > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Subproject > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/Tuscany+SCA+Java+-+FAQ > > > > > > > > > > > > > > > > - Each subproject has a general section and a subproject > > > specific > > > > > > > > section. > > > > > > > > (we could combine these two into one section if we want. I > > kept > > > it > > > > > > > > separate > > > > > > > > for readability purposes) > > > > > > > > Example: > > > > > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Subproject > > > > > > > > > > > > > > > > > > > > > > > - Each subproject has a Download link and a Documentation > > > Link. > > > > > > > > a) Downloads (points to a release page for the > subproject > > > > like > > > > > > > Venkat > > > > > > > > was asking for) > > > > > > > > Example: > > > > > > > > > > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/SCA+Java+Releases > > > > > > > > b) Documentation link points to a page that is indexed > to > > > all > > > > > the > > > > > > > > > > > > > > > documentations for the subproject. > > > > > > > > Example: > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > http://cwiki.apache.org/confluence/display/TUSCANY/Java+SCA+Documentation+Menu > > > > > > > > > > > > > > > > > > > > > > > If this looks OK, I'll go ahead and make similar updates for > > > other > > > > > > > > subprojects tomorrow. > > > > > > > > > > > > > > > > Haleh > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >