[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
Re: [cosmos-dev] Re: Wiki naming conventions
|
So everyone is aware, I'm telling my team to create pages with the
following structure:
http://wiki.eclipse.org/COSMOS_SDD_Tooling_{tool}_{topic}
At the bottom of every page, we'll have the following categories:
[[Category:COSMOS]] [[Category:SDD Tooling]]
Let me know if there are any issues with that format,
-Chris
2008/1/16 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
>
> _______________________________________________
> cosmos-dev mailing list
> cosmos-dev@xxxxxxxxxxx
> https://dev.eclipse.org/mailman/listinfo/cosmos-dev
>
>