updating the Sugar manual for 8.4 release

[Anne Gentle]

Hi all -
I'm Anne Gentle and I've been working as a volunteer with FLOSS Manuals to coordinate the Sugar and OLPC documentation over the last year and a half.

We have a pair of manuals for Sugar and the XO, written for the 8.2 release. The manual content also loads in the Help Activity shipped with each Sugar installation. For example, the Sugar Users Guide written at the Book Sprint last August can be downloaded or purchased here:  http://www.lulu.com/content/paperback_book/sugar_users_guide/3865497.

With the new 8.4 release coming up in a very short time, I've read through the users guide and the release notes at http://sugarlabs.org/go/DevelopmentTeam/Release/Releases/Sucrose/0.84 and come up with these areas of concentration for revisions.

I'd like for people to jump in on any chapter they can help with. Ideally we can complete revisions and screenshot updates by March 13th to coordinate with the software release itself. I'll keep an eye on the content on that date and determine the best course of action, but I'd like to keep that as our goal. Register for a login with FLOSS Manuals if you do not already have one at http://en.flossmanuals.net/bin/view/Main/UserRegistration?origurl=/bin/view/Main/WebHome.

Once these updates are completed, FLOSS Manuals will offer a printed book for sale on Amazon (once we get the process ironed out) and Lulu. PDF and HTML versions are always available for free.

The Frame - http://en.flossmanuals.net/bin/view/Sugar/8_4/TheFrame
Double-check all screenshots and descriptions to ensure they still match current reality.

The Journal - http://en.flossmanuals.net/bin/view/Sugar/8_4/TheJournal
Double-check all screenshots and descriptions to ensure they still match current reality.

Personalizing Sugar - http://en.flossmanuals.net/bin/view/Sugar/8_4/Personalising
This chapter is about the control panel. I believe the Control Panel screen has changed (for example, it no longer says About your XO). Frame Configuration may have changed. Software Update may have changed.

Launching Activities - http://en.flossmanuals.net/bin/view/Sugar/8_4/LaunchingActivities
Resuming from Journal may have changed. Journal inteface may have changed requiring screenshot updates. Turtle Art's interface has changed and the screenshot should be updated. Frame icons around "Stop" may have changed.

Installing Activities - http://en.flossmanuals.net/bin/view/Sugar/8_4/InstallingActivities
All of this chapter's screenshots should be updateed to show where you download Activities now.

Activities Sampler -
http://en.flossmanuals.net/bin/view/Sugar/8_4/FindingActivities
Turtle Art screenshot should be changed. Double-check all screenshots and descriptions to ensure they still match current reality. Add InfoSlicer Activity in the sampler set and take a screenshot. See if other Activities have been added that belong in the sampler.

Turtle Art Demonstration - http://flossmanuals.net/write/WebHome/TurtleArt/
Double-check all screenshots and descriptions to ensure they still match current reality.

Getting Connected - http://en.flossmanuals.net/bin/view/Sugar/8_4/ConnectingNetwork
The Frame screenshot after Step 4: Checking the connection should be checked. I don't think the rest of the screenshots need to change but do double-check.

Backing Up - http://en.flossmanuals.net/bin/view/Sugar/8_4/BackingUp
Double-check all screenshots and descriptions to ensure they still match current reality.

Conserving Disk Space - http://en.flossmanuals.net/bin/view/Sugar/8_4/ConservingDiskspace
Double-check all screenshots and descriptions to ensure they still match current reality.

Thanks all for taking the time to help out with this important release.
Anne
--
Anne Gentle
email: [hidden email]
blog: www.justwriteclick.com

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Jonas Smedegaard]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Mon, Mar 09, 2009 at 10:31:39PM -0500, Anne Gentle wrote:
>With the new 8.4 release coming up in a very short time, I've read
>through the users guide and the release notes

Are OLPC planning an 8.4 release of their XO-specific distribution?

If not, I suspect that you are actually referring to the 0.84 release of
the Sugar desktop.


In the past, the XO distribution, Sugar desktop and individual parts of
Sugar have used similar looking numbers for their releases.

Please be careful what you are referring to, and use correct version
number for it. Especially if it ends up in documentation.


Kind regards,

  - Jonas

- --
* Jonas Smedegaard - idealist og Internet-arkitekt
* Tlf.: [phone]  Website: http://dr.jones.dk/

  [x] quote me freely  [ ] ask before reusing  [ ] keep private
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkm2NAEACgkQn7DbMsAkQLjF2gCfVWqeY5EC6i6oH+YXPdqflmbX
2eoAnA1s4VIttCVPtY2aDNCmHD3W2jVN
=k6yF
-----END PGP SIGNATURE-----
_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Sean DALY]

Hi Anne, I've been confused too and we have worked out a way forward:

The version number of Sugar which will be launched this Monday the 16th is 0.84

When Sugar on a Stick is ready in Q3 of this year, it will be version 1.0

thanks

Sean
Marketing Coordinator



On Tue, Mar 10, 2009 at 10:33 AM, Jonas Smedegaard <[hidden email]> wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> On Mon, Mar 09, 2009 at 10:31:39PM -0500, Anne Gentle wrote:
>>With the new 8.4 release coming up in a very short time, I've read
>>through the users guide and the release notes
>
> Are OLPC planning an 8.4 release of their XO-specific distribution?
>
> If not, I suspect that you are actually referring to the 0.84 release of
> the Sugar desktop.
>
>
> In the past, the XO distribution, Sugar desktop and individual parts of
> Sugar have used similar looking numbers for their releases.
>
> Please be careful what you are referring to, and use correct version
> number for it. Especially if it ends up in documentation.
>
>
> Kind regards,
>
>  - Jonas
>
> - --
> * Jonas Smedegaard - idealist og Internet-arkitekt
> * Tlf.: [phone]  Website: http://dr.jones.dk/
>
>  [x] quote me freely  [ ] ask before reusing  [ ] keep private
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.9 (GNU/Linux)
>
> iEYEARECAAYFAkm2NAEACgkQn7DbMsAkQLjF2gCfVWqeY5EC6i6oH+YXPdqflmbX
> 2eoAnA1s4VIttCVPtY2aDNCmHD3W2jVN
> =k6yF
> -----END PGP SIGNATURE-----
> _______________________________________________
> IAEP -- It's An Education Project (not a laptop project!)
> [hidden email]
> http://lists.sugarlabs.org/listinfo/iaep
>

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Walter Bender-4]

On Mon, Mar 9, 2009 at 11:31 PM, Anne Gentle <[hidden email]> wrote:
> Hi all -
> I'm Anne Gentle and I've been working as a volunteer with FLOSS Manuals to
> coordinate the Sugar and OLPC documentation over the last year and a half.
>
[snip]
> I'd like for people to jump in on any chapter they can help with. Ideally we
> can complete revisions and screenshot updates by March 13th to coordinate
> with the software release itself. I'll keep an eye on the content on that
> date and determine the best course of action, but I'd like to keep that as
> our goal. Register for a login with FLOSS Manuals if you do not already have
> one at
> http://en.flossmanuals.net/bin/view/Main/UserRegistration?origurl=/bin/view/Main/WebHome.
>
[snip]
> The Frame - http://en.flossmanuals.net/bin/view/Sugar/8_4/TheFrame
> Double-check all screenshots and descriptions to ensure they still match
> current reality.
>
> The Journal - http://en.flossmanuals.net/bin/view/Sugar/8_4/TheJournal
> Double-check all screenshots and descriptions to ensure they still match
> current reality.

I'll volunteer for this one.

> Personalizing Sugar -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/Personalising
> This chapter is about the control panel. I believe the Control Panel screen
> has changed (for example, it no longer says About your XO). Frame
> Configuration may have changed. Software Update may have changed.
>
> Launching Activities -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/LaunchingActivities
> Resuming from Journal may have changed. Journal inteface may have changed
> requiring screenshot updates. Turtle Art's interface has changed and the
> screenshot should be updated. Frame icons around "Stop" may have changed.
>
> Installing Activities -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/InstallingActivities
> All of this chapter's screenshots should be updateed to show where you
> download Activities now.

I am hoping the team that built the addons site
(activities.sugarlabs.org) would be the correct group to work on a
refactoring of this chapter.

> Activities Sampler -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/FindingActivities
> Turtle Art screenshot should be changed. Double-check all screenshots and
> descriptions to ensure they still match current reality. Add InfoSlicer
> Activity in the sampler set and take a screenshot. See if other Activities
> have been added that belong in the sampler.

I can help with this one too.

> Turtle Art Demonstration - http://flossmanuals.net/write/WebHome/TurtleArt/
> Double-check all screenshots and descriptions to ensure they still match
> current reality.
>
> Getting Connected -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/ConnectingNetwork
> The Frame screenshot after Step 4: Checking the connection should be
> checked. I don't think the rest of the screenshots need to change but do
> double-check.
>
> Backing Up - http://en.flossmanuals.net/bin/view/Sugar/8_4/BackingUp
> Double-check all screenshots and descriptions to ensure they still match
> current reality.
>
> Conserving Disk Space -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/ConservingDiskspace
> Double-check all screenshots and descriptions to ensure they still match
> current reality.
>

-walter
--
Walter Bender
Sugar Labs
http://www.sugarlabs.org
_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Anne Gentle-2]

My apologies. I hear "eight four" and transcribe in my head to eight dot four, but it is point eight four. Thanks for clarifying.

Thank you Walter for signing up for chapters!

Also, Sean, thank you for the date update. Let's make our goal 3/16 instead of 3/13. I'm delighted to get three more days.
Thanks,
Anne

On Tue, Mar 10, 2009 at 4:33 AM, Jonas Smedegaard <[hidden email]> wrote:

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Mon, Mar 09, 2009 at 10:31:39PM -0500, Anne Gentle wrote:
>With the new 8.4 release coming up in a very short time, I've read
>through the users guide and the release notes

Are OLPC planning an 8.4 release of their XO-specific distribution?

If not, I suspect that you are actually referring to the 0.84 release of
the Sugar desktop.


In the past, the XO distribution, Sugar desktop and individual parts of
Sugar have used similar looking numbers for their releases.

Please be careful what you are referring to, and use correct version
number for it. Especially if it ends up in documentation.


Kind regards,

 - Jonas

- --
* Jonas Smedegaard - idealist og Internet-arkitekt
* Tlf.: [phone]  Website: http://dr.jones.dk/

 [x] quote me freely  [ ] ask before reusing  [ ] keep private
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkm2NAEACgkQn7DbMsAkQLjF2gCfVWqeY5EC6i6oH+YXPdqflmbX
2eoAnA1s4VIttCVPtY2aDNCmHD3W2jVN
=k6yF
-----END PGP SIGNATURE-----

--
Anne Gentle
email: [hidden email]
blog: www.justwriteclick.com

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Rita Freudenberg]

Anne Gentle wrote:
>
>
> Installing Activities -
> http://en.flossmanuals.net/bin/view/Sugar/8_4/InstallingActivities
> All of this chapter's screenshots should be updateed to show where you
> download Activities now.
Ok, the screenshot for Etoys is updated. By the way, there is no Etoys
manual yet. Anne, could you add an entry for "Etoys Activity", so that
we can start writing a manual?

greetings,
Rita
>


--
Rita Freudenberg
FIN-ISG
Otto-von-Guericke-Universität Magdeburg
http://isgwww.cs.uni-magdeburg.de/isg/rita.html

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[Rita Freudenberg]

Rita Freudenberg wrote:
> Anne Gentle wrote:
>>
>>
>> Installing Activities -
>> http://en.flossmanuals.net/bin/view/Sugar/8_4/InstallingActivities
>> All of this chapter's screenshots should be updateed to show where
>> you download Activities now.
Sorry, I didn't update the InstallingActivities, but the
FindingActivities site here:
http://en.flossmanuals.net/bin/view/Sugar/8_4/FindingActivities

Rita
> Ok, the screenshot for Etoys is updated. By the way, there is no Etoys
> manual yet. Anne, could you add an entry for "Etoys Activity", so that
> we can start writing a manual?
>
> greetings,
> Rita
>>
>
>


--
Rita Freudenberg
FIN-ISG
Otto-von-Guericke-Universität Magdeburg
http://isgwww.cs.uni-magdeburg.de/isg/rita.html

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library

[David Farning-5]

On 3/10/09, Rita Freudenberg <[hidden email]> wrote:

> Anne Gentle wrote:
>>
>>
>> Installing Activities -
>> http://en.flossmanuals.net/bin/view/Sugar/8_4/InstallingActivities
>> All of this chapter's screenshots should be updateed to show where you
>> download Activities now.
> Ok, the screenshot for Etoys is updated. By the way, there is no Etoys
> manual yet. Anne, could you add an entry for "Etoys Activity", so that
> we can start writing a manual?

Anne,

Is creating new activity manuals something I can do?  That would seems
to be a easy task that I or someone else can take off of your plate.


david

> greetings,
> Rita
>>
>
>
> --
> Rita Freudenberg
> FIN-ISG
> Otto-von-Guericke-Universität Magdeburg
> http://isgwww.cs.uni-magdeburg.de/isg/rita.html
>
> _______________________________________________
> IAEP -- It's An Education Project (not a laptop project!)
> [hidden email]
> http://lists.sugarlabs.org/listinfo/iaep
>

_______________________________________________
Library mailing list
[hidden email]
http://lists.laptop.org/listinfo/library