Re: Introduction to GNOME in 2.6

[Shaun McCance <shaunm gnome org>]

On Wed, 2004-03-24 at 16:26, Luis Villa wrote:
> Seems very reasonable, though how long is the section in question? Would
> it be impossible to rewrite over the weekend?
> Luis

Sorry, let me clarify.  We currently ship four documents in
gnome2-user-docs:

GNOME User's Guide
GNOME System Administrator's Guide
GNOME Accessibility Guide
Introduction to GNOME

Intro is the smallest.  The XML file weighs in at 1983 lines, though
that's not much of an indication of its size.  It's 10 sections long,
though the meat of the document starts at section 4.  You can read it
with the command

yelp ghelp:introduction-to-gnome

The Nautilus changes are the biggest problem, I think.  We'd have to
rescreenshot Figure 4-1, and update Section 4.2 to describe Computer. 
Section 6 is all about Nautilus, so it would probably just have to be
rewritten.  Section 7 needs some edits for the One True Panel.  And
Section 8 would need to be updated to account for new applications and
applications that have gone the way of the dodo.

It's not a huge document, and updating it should be feasible.  I'm a bit
worried about pushing a document that hasn't had time for review, but if
somebody wants to take a crack at it in the next week, I certainly won't
stop them.  I'll be out of town for the weekend, so I won't be able to
do it.

So here's a revised proposal:  I can wait until Monday morning or so for
this.  If somebody does the updates, I can roll a 2.6.1 with the updates
included.  Otherwise, I can roll a 2.6.0-1 with Intro removed.

--
Shaun

> On Wed, 2004-03-24 at 16:26 -0600, Shaun McCance wrote:
> 
> > On Sat, 2004-03-20 at 08:34, Alexander Kirillov wrote:
> > > Hi guys:
> > > "Introduction to GNOME" document - in gnome-user-docs package - was not
> > > updated in a while (since summer, I believe). This is my fault - didn't
> > > have time to do it. In its curretn form, it will do more harm than good
> > > if we ship it with GNOME 2.6. 
> > > 
> > > So I'd suggest removing it altogether from the package, at least for now
> > > - and probalby for good. Do we need release team blessing for this? 
> > 
> > So gnome2-user-docs 2.6.0 shipped with Intro, because this completely
> > slipped my mind.  Soon thereafter, somebody was complaining on IRC that
> > he was seeing GNOME 2.2 docs with the latest GARNOME.  The document in
> > question was, of course, "Introduction to GNOME".
> > 
> > I have to agree that having an outdated Intro does more harm than good. 
> > All the information people need is in the User Guide, though Intro may
> > have provided it in a more digestable form.
> > 
> > Release team:  Given the 2.6.0 extension due to the recent attacks,
> > would it be acceptable to roll a 2.6.0-1 with Intro removed?