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
> > > > > > >
> > > > > >
> > > > >
> > > > >
> > > >
> > >
> >
>