Talk:Documentation Team - Revision history

Cjl: moved Talk:Walter is a wanker 9 to Talk:Documentation Team over redirect: revert

2010-02-25T00:15:20Z

moved Talk:Walter is a wanker 9 to Talk:Documentation Team over redirect: revert

← Older revision	Revision as of 20:15, 24 February 2010
(No difference)

Faggot: moved Talk:Documentation Team to Talk:Walter is a wanker 9: Walter is a wanker

2010-02-24T23:47:46Z

moved Talk:Documentation Team to Talk:Walter is a wanker 9: Walter is a wanker

← Older revision	Revision as of 19:47, 24 February 2010
(No difference)

FGrose: Talk:DocumentationTeam moved to Talk:Documentation Team: deCamel casing

2009-03-17T20:59:02Z

Talk:DocumentationTeam moved to Talk:Documentation Team: deCamel casing

← Older revision	Revision as of 16:59, 17 March 2009
(No difference)

Annegentle: /* Try Sugar I */

2008-08-16T11:48:00Z

Try Sugar I

← Older revision		Revision as of 07:48, 16 August 2008
Line 46:		Line 46:

	I think it is a critical part of this effort that we document how to try Sugar on existing platforms (e.g., use of a LiveCD). This will make it easier for teachers and parents to get comfortable enough to make the capital investment in the hardware. --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)		I think it is a critical part of this effort that we document how to try Sugar on existing platforms (e.g., use of a LiveCD). This will make it easier for teachers and parents to get comfortable enough to make the capital investment in the hardware. --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)

			I want to think about this and figure out a good approach. We have a teacher in Austin who might be a good person to send drafts to. I'll try to think of a good way to integrate this into the doc. [[User:Annegentle\|Annegentle]] 11:47, 16 August 2008 (UTC)

	== Try Sugar II ==		== Try Sugar II ==

Annegentle: /* Try Sugar II */

2008-08-16T11:47:05Z

Try Sugar II

← Older revision		Revision as of 07:47, 16 August 2008
Line 50:		Line 50:

	I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example? --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)		I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example? --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)

	I'd love to learn enough to write a tutorial on this scenario. Let's work on it. [[User:Annegentle\|Annegentle]] 11:46, 16 August 2008 (UTC)		I'd love to learn enough to write a tutorial on this scenario. Let's work on it. [[User:Annegentle\|Annegentle]] 11:46, 16 August 2008 (UTC)

Annegentle: /* Try Sugar II */

2008-08-16T11:46:52Z

Try Sugar II

← Older revision		Revision as of 07:46, 16 August 2008
Line 50:		Line 50:

	I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example? --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)		I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example? --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)
			I'd love to learn enough to write a tutorial on this scenario. Let's work on it. [[User:Annegentle\|Annegentle]] 11:46, 16 August 2008 (UTC)

Walter: /* Try Sugar II */

2008-08-11T17:54:30Z

Try Sugar II

← Older revision		Revision as of 13:54, 11 August 2008
Line 49:		Line 49:
	== Try Sugar II ==		== Try Sugar II ==

	I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example?		I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example? --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)

Walter: /* Try Sugar I */

2008-08-11T17:54:16Z

Try Sugar I

← Older revision		Revision as of 13:54, 11 August 2008
Line 45:		Line 45:
	== Try Sugar I ==		== Try Sugar I ==

	I think it is a critical part of this effort that we document how to try Sugar on existing platforms (e.g., use of a LiveCD). This will make it easier for teachers and parents to get comfortable enough to make the capital investment in the hardware.		I think it is a critical part of this effort that we document how to try Sugar on existing platforms (e.g., use of a LiveCD). This will make it easier for teachers and parents to get comfortable enough to make the capital investment in the hardware. --[[User:Walter\|Walter]] 17:54, 11 August 2008 (UTC)

	== Try Sugar II ==		== Try Sugar II ==

	I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example?		I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example?

Walter: /* Try Sugar I & II */

2008-08-11T17:54:03Z

Try Sugar I & II

← Older revision		Revision as of 13:54, 11 August 2008
Line 42:		Line 42:
	* Probably good to have a pygame tutorial, it's probably the best thing we have at the moment to do free form graphics stuff.		* Probably good to have a pygame tutorial, it's probably the best thing we have at the moment to do free form graphics stuff.
	* Etoys based activity tutorial?		* Etoys based activity tutorial?

			== Try Sugar I ==

			I think it is a critical part of this effort that we document how to try Sugar on existing platforms (e.g., use of a LiveCD). This will make it easier for teachers and parents to get comfortable enough to make the capital investment in the hardware.

			== Try Sugar II ==

			I think it is also a critical part of this effort to introduce to the user community the notion of modifying code. Perhaps an example of modifying the Home View from a circle to a spiral would be a good example?

Dfarning: Moved documentation discussion from main to talk

2008-06-27T21:28:39Z

Moved documentation discussion from main to talk

← Older revision		Revision as of 17:28, 27 June 2008
Line 19:		Line 19:
	A nice-to-have in all of this would be the ability to call up the relevent documentation while coding, as can be done in Visual Studio.		A nice-to-have in all of this would be the ability to call up the relevent documentation while coding, as can be done in Visual Studio.
	[[User:Davewa\|dave]] 20:03, 19 May 2008 (UTC)		[[User:Davewa\|dave]] 20:03, 19 May 2008 (UTC)



			* sugar-base and sugar-toolkit has API documentation in the code. What tool do we use to generate html? Where do we generate it and where we make it available? Do we need to build them to generate docs?
			:* See http://wiki.laptop.org/go/API_reference#System_Services.2FHardware for PyDoc and epydoc references. Also, how do we want to reference http://wiki.laptop.org/go/API_reference? Is it out of date? Do we start from scratch, or just update that? --[[User:Morgs\|Morgs]] 14:57, 30 May 2008 (UTC)
			* Probably we should document the datastore dbus API. I'm not sure what's the best way to generate documentation for it. It's so small that a wiki page might be the simpler solution for now.
			* Collaboration API. I have no idea, morgs we need your help here.
			:* Existing collaboration documentation is at [http://wiki.laptop.org/go/Category:Collaboration] --[[User:Morgs\|Morgs]] 19:59, 15 May 2008 (UTC)
			::* Morgs, my impression after a 3 minutes look over the available documentation is that there is little written with activity authors in mind, and that it's dispersed in several pages and mixed with implementation docs. Is that impression correct? I would like to have a couple of things: 1 complete documentation of the API which interest activity authors (with good links to dbus documentation since it's used so heavily) 2 A complete tutorial as part of the "manual". One of the Tubes pages looks like a pretty good start in this respect. Does it make sense to you? Can we make it happen? -- [[User:Marcopg\|Marcopg]]
			:::* Yes we can! --[[User:Morgs\|Morgs]] 13:50, 16 May 2008 (UTC)
			:::* Hey, I came up with an alternate "reference" implementation for collaboration when I wrote Colors!, I think it's a lot easier to understand and could be the basis for a good tutorial. The only weird thing is, I wanted my activity class to receive DBus signals directly, so I subclassed ExportedGObject but initialized late - hacky, I know. It would be nice if this were not needed! [http://dev.laptop.org/git?p=activities/colors;a=blob;f=colors.py;h=c262f55e46519248418a07e3c4eed1ab4207fa09;hb=5822328cab1162b32452dfb915b33d98307b55d1#l579] [[User:Wade\|Wade]] 18:49, 18 May 2008 (UTC)
			* Low level API (non-python activities). We should just move bert document on this wiki.
			:this is the page http://wiki.laptop.org/go/Low-level_Activity_API but it must be complemented with
			:* http://wiki.laptop.org/go/Sugar_Factory
			:* http://www.catmoran.com/olpc/#sugxterm

			== Manual ==

			* Setup a development environment. This is wiki oriented so we should probably not even mention jhbuild (we should definitely not do so until we have a bunch of autobuild slaves running).
			* "Write your activity" tutorial. It should include all the important bits: graphic controls, datastore, collaboration
			** see OLPC Austria's [http://www.olpcaustria.org/mediawiki/index.php/Activity_handbook Activity Handbook] [[User:ChristophD\|ChristophD]] 03:59, 30 May 2008 (UTC)
			* Probably good to have a pygame tutorial, it's probably the best thing we have at the moment to do free form graphics stuff.
			* Etoys based activity tutorial?