It's all about the answers!

Ask a question

Would a focused "Getting started" forum be useful?


Bill Higgins (24611) | asked Nov 06 '07, 12:53 a.m.
The Jazz.net team have been discussing whether or not to create an additional forum dedicated to "Getting Started using Rational Team Concert" questions and problems.

The thought is that "Getting Started" questions are very interesting to new users but not very interesting to more experienced users. So by decoupling these two types of questions, we can provide better, more focused information to both new and experienced users.

Also, having Getting Started questions in a focused area would help the development team:

1) More easily identify common Getting Started pain points (a focus area we always seek to improve upon), and
2) Help improve our Getting Started documentation

Please vote and if time allows, add a comment with your thoughts.

8 answers



permanent link
Christophe Elek (2.9k13021) | answered Nov 06 '07, 6:18 a.m.
JAZZ DEVELOPER
bhiggins@us.ibm-dot-com.no-spam.invalid (bhiggins) wrote in news:fgovou$17f
$1@localhost.localdomain:

Please vote and if time allows, add a comment with your thoughts.

+1, could we have a dictionnary too ? I am lost as to what a stream is
versus a workspace versus a delta versus... etc etc.. :)


--
Christophe Elek
Serviceability Architect
IBM Software Group - Rational

permanent link
Tom Frauenhofer (1.3k58435) | answered Nov 06 '07, 9:02 a.m.
Seconded ..... I've not new to source control, but I've had the devil of a
time understanding what are Streams, Components, and Projects within
Components

permanent link
Aaron Cohen (8207851) | answered Nov 07 '07, 9:18 a.m.
JAZZ DEVELOPER
Jazz like many other Software applications has a learning curve and we need to help users to get pass this. Currently the two forums have clearly defined actions which are extending Jazz and everything else. If we are going to have a getting started session, we should define what are getting started activities vs other activities.

permanent link
Christophe Elek (2.9k13021) | answered Nov 07 '07, 11:52 a.m.
JAZZ DEVELOPER
"Richard O. Curtis" <rocurtis@us.ibm.com> wrote in
news:fgstc2$nas$1@localhost.localdomain:


M4a has the beginnings of some help that addresses at least a few of
these concepts. From the main menu, click Help > Help Contents, then
click Using Rational Team Concert > Managing Source Code in Jazz
Overview of configuration management. You can also search for the
terms of interest, though the weighting of what's returned is a little
uneven at the moment,


Thanks Richard, where do we open defects or feature request ? UA ?
How do we propose content ? (I am thinkng of a 'troubleshooting' section) ?
Should we wiki it soomewhere so people can contrinbute ? Ala open source ?
:D

--
Christophe Elek
Serviceability Architect
IBM Software Group - Rational

permanent link
Richard Curtis (6111) | answered Nov 07 '07, 12:48 p.m.
M4a has the beginnings of some help that addresses at least a few of these concepts. From the main menu, click Help > Help Contents, then click Using Rational Team Concert > Managing Source Code in Jazz > Overview of configuration management. You can also search for the terms of interest, though the weighting of what's returned is a little uneven at the moment,


Richard O. Curtis
Senior Information Developer
IBM Rational Software
20 Maguire Rd.
Lexington, MA 02421-3112

781-676-2691 //voice
rocurtis@us.ibm.com //inet

<davidward@us.ibm.com> wrote in message news:fgqa7k$jc0$1@localhost.localdomain...

Seconded ..... I've not new to source control, but I've had the devil of a time understanding what are Streams, Components, and Projects within Components

permanent link
Chris Daly (61651) | answered Nov 07 '07, 2:38 p.m.
JAZZ DEVELOPER
Richard O. Curtis wrote:
M4a has the beginnings of some help that addresses at least a few of

This is sort of off-topic, but I think you mean M4D1, right?

Actually, since this is a "Getting started" thread and people new to
Jazz may be confused about our release labeling, we have been using
lowercase letter suffixes (a, b, ...) to indicate a rebuild to fix some
serious bugs. So M4a would be a bugfix release based on M4 with just
fixes for the serious bugs found. Eclipse also uses this naming pattern
for rebuilds (anyone remember Eclipse 3.3M5eh
http://dev.eclipse.org/mhonarc/lists/eclipse-dev/msg07700.html).

Suffixes like D1 (as in M4D1) indicate a "deployment" before the
milestone. This naming scheme and the deployment/migration issues
around it are explained on this wiki:

https://jazz.net/wiki/bin/view/Main/Migration06

The progression of recent build labels looks like this:

....
M3D1
M3
M3a (oops, we need to fix M3!)
M4D1 (we are here - I20071101-2006)
M4 (coming soon)
M4a (hopefully not necessary)
....


Sorry if this sounds pedantic, but I can easily see people getting
confused by our labeling so hopefully this will be more helpful than
annoying. :-)


Chris

permanent link
Richard Curtis (6111) | answered Nov 08 '07, 12:18 p.m.
You can open a workitem and assign it to the User Assistance category.

-r
"Christophe Elek" <Christophe.Elek@gmail.com> wrote in message
news:Xns99E1A18AB8066celekcaibmcom@199.246.40.53...
"Richard O. Curtis" <rocurtis@us.ibm.com> wrote in
news:fgstc2$nas$1@localhost.localdomain:


M4a has the beginnings of some help that addresses at least a few of
these concepts. From the main menu, click Help > Help Contents, then
click Using Rational Team Concert > Managing Source Code in Jazz
Overview of configuration management. You can also search for the
terms of interest, though the weighting of what's returned is a little
uneven at the moment,


Thanks Richard, where do we open defects or feature request ? UA ?
How do we propose content ? (I am thinkng of a 'troubleshooting' section)
?
Should we wiki it soomewhere so people can contrinbute ? Ala open source ?
:D

--
Christophe Elek
Serviceability Architect
IBM Software Group - Rational

permanent link
Seth Packham (1.4k42213) | answered Nov 30 '07, 2:58 p.m.
FORUM ADMINISTRATOR / JAZZ DEVELOPER
Actually, use the "Documentation - User Assistance" category. It might have changed since Richard posted.

In response to the original question, I think this board would benefit from more organization. Maybe categories like this would be good under jazz.user:

+ Getting started questions (Newbies)

+ Installing, Configuring, and Administering
(Getting the tools installed, configured, and then administering the system)

+ Migrating and Upgrading
(Migrating from other systems or industry tools, upgrading from different versions)

+ General use questions and discussion

Maybe that's too much :-) but I see lots of forums with more useful categories like that.

Your answer


Register or to post your answer.


Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.