Re: [cosmos-dev] Re: Wiki naming conventions

[David Whiteman <David_Whiteman@xxxxxxxxxx>]

I think the problem Chris highlighted
is that after we have created so many of these pages, it gets harder to
maintain and organize the pages without perhaps going to a directory naming
structure, or some sort of naming convention on our project.   I think
we should probably put something in our dev process about wiki page naming,
maybe just something as general as the suggestion to qualify your page
name as much as possible to prevent collisions with other eclipse projects.

David

Mark Weitzel wrote on 01/16/2008 01:51:24 PM:

> As to the question of naming conventions.... 
> I'm not aware of any specific guidelines for the wiki.  A general
rule of thumb 
> that I try to follow is if a page name can apply across multiple projects,
e.g. 
> "Release Engineering" or "Meeting Minutes", then
I try to prefix it with "COSMOS", e.g. 
> http://wiki.eclipse.org/COSMOS_Architecture_Meetings 
> 
> -mw
> 
> _______________________________________________________________________________________________________________
> Mark Weitzel | STSM | IBM Software Group | Tivoli | Autonomic Computing
| (919) 543
> 0625 | weitzelm@xxxxxxxxxx 
> 

> 
> [image removed] 
> 
> [cosmos-dev] Re: Wiki naming conventions
> 
> Chris Mildebrandt 
> 
> to: 
> 
> cosmos-dev 
> 
> 01/16/08 01:38 PM
> 
> Sent by: 
> 
> cosmos-dev-bounces@xxxxxxxxxxx
> 
> 
> Please respond to Cosmos Dev <cosmos-dev@xxxxxxxxxxx> 
> 
> 

> 
> 
> 
> 
> 
> I was recently told of the convention for design documents (bugzilla
> number), but I'd still like to find an answer for other wiki pages.
> 
> Thanks,
> -Chris
> 
> On Jan 16, 2008 12:29 PM, Chris Mildebrandt <cosmos@xxxxxxxxxxxxxxxx>
wrote:
> > Hi all,
> >
> > Some know me, some don't. I'm the SDD tooling lead in IBM. I
had a
> > question about the naming of wiki pages on the wiki.eclipse.org
site.
> > It looks to be a very flat structure currently. Should I be concerned
> > about how that can scale? I just created the following page in
the
> > wiki:
> >
> > http://wiki.eclipse.org/COSMOS/SDD_Tooling/BTG/Design
> >
> > Should the flat structure be maintained? For example:
> > http://wiki.eclipse.org/BTG_Design. Or David Whiteman suggested
a
> > possible namespace prefix to make it look like this:
> > http://wiki.eclipse.org/COSMOS_SDD_BTG_Design. Or should I stick
with
> > what I have done?
> >
> > Is there a convention to be followed? Or if not, should there
be?
> >
> > Thanks,
> > -Chris Mildebrandt
> >
> _______________________________________________
> cosmos-dev mailing list
> cosmos-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/cosmos-dev
> _______________________________________________
> cosmos-dev mailing list
> cosmos-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/cosmos-dev