Talk:User manual - Revision history

Spiralofhope: /* Dangerous unsourced battery charging information */

2012-05-10T21:40:00Z

‎Dangerous unsourced battery charging information

Spiralofhope: /* Terminal Commands */

2012-05-10T21:14:10Z

‎Terminal Commands

Spiralofhope: /* Keyboard Layout */ - completed

2012-05-10T20:51:26Z

‎Keyboard Layout: - completed

Cheese: /* Dangerous unsourced battery charging information */

2012-02-25T04:05:07Z

‎Dangerous unsourced battery charging information

Spiralofhope: /* Dangerous unsourced battery charging information */ new section

2012-02-22T19:12:16Z

‎Dangerous unsourced battery charging information: new section

Spiralofhope: /* splitting into smaller articles */

2012-02-22T18:49:49Z

‎splitting into smaller articles

Spiralofhope: /* splitting into smaller articles */

2012-02-22T18:49:15Z

‎splitting into smaller articles

Esn: /* splitting into smaller articles */

2011-04-23T05:02:59Z

‎splitting into smaller articles

Esn: /* splitting into smaller articles */

2011-04-23T05:02:12Z

‎splitting into smaller articles

ABC: /* splitting into smaller articles */ more splitting?

2011-04-22T15:08:23Z

‎splitting into smaller articles: more splitting?

← Older revision		Revision as of 21:40, 10 May 2012
Line 38:		Line 38:

	Discharging batteries, putting them in the fridge etc.. is very old knowledge. This does not apply to new technologies. Suggesting this sort of thing is wrong unless we can get official statements talking about the battery technology and we can confirm from _proper_ sources that treating a battery in this manner is a good idea. "I read it somewhere" or "I've done this for years" are not good enough. Propagating crappy advice like that is akin to telling people to sleep with it under their pillows so the demons don't get at it. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 20:12, 22 February 2012 (CET)		Discharging batteries, putting them in the fridge etc.. is very old knowledge. This does not apply to new technologies. Suggesting this sort of thing is wrong unless we can get official statements talking about the battery technology and we can confirm from _proper_ sources that treating a battery in this manner is a good idea. "I read it somewhere" or "I've done this for years" are not good enough. Propagating crappy advice like that is akin to telling people to sleep with it under their pillows so the demons don't get at it. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 20:12, 22 February 2012 (CET)
		+
	:Heh heh... a bit of an extreme example but you make a good point. The information here should be stuff you can rely on, not hearsay. [[User:Cheese\|Cheese]] 05:05, 25 February 2012 (CET)		:Heh heh... a bit of an extreme example but you make a good point. The information here should be stuff you can rely on, not hearsay. [[User:Cheese\|Cheese]] 05:05, 25 February 2012 (CET)
		+
		+	:: I'm going to work on this issue more seriously: [http://boards.openpandora.org/index.php?/topic/8276-battery-information/] — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 23:40, 10 May 2012 (CEST)

← Older revision		Revision as of 21:14, 10 May 2012
Line 11:		Line 11:

	:I disagree. A lot of tutorials have terminal commands, and they seem to be needed even for some basic and important things such as making sure that the [[NAND]] doesn't run out of room. Instead of leaving them out, there needs to be a simple, easy-to-follow explanation of how to get to a window where you can type them in (not explaining all the technicalities, just simple (1) (2) (3) instructions that any layman can follow). I'd do it myself, but I won't have my system for another few days yet. Maybe then. Also, I've never used Linux and used terminal commands in Windows/DOS only very rarely, so I'll try to make it as stupidly-simply as possible. :p [[User:Esn\|Esn]] 23:05, 14 January 2011 (MET)		:I disagree. A lot of tutorials have terminal commands, and they seem to be needed even for some basic and important things such as making sure that the [[NAND]] doesn't run out of room. Instead of leaving them out, there needs to be a simple, easy-to-follow explanation of how to get to a window where you can type them in (not explaining all the technicalities, just simple (1) (2) (3) instructions that any layman can follow). I'd do it myself, but I won't have my system for another few days yet. Maybe then. Also, I've never used Linux and used terminal commands in Windows/DOS only very rarely, so I'll try to make it as stupidly-simply as possible. :p [[User:Esn\|Esn]] 23:05, 14 January 2011 (MET)
		+
		+	Duplication of existing Linux or application documentation must be kept at a minimum. Writing about basic commands for common usage is ok, but for more advanced usage, Pandora documentation should point the user to official resources. If the official resources suck, then for sure we write better stuff here and then make fun of the official guys to goad them into fixing themselves. I'll stress these and other philosophies as I go through the existing docs here. More ranting on my [[User:Spiralofhope/documentation philosophies\|documentation philosophies]] page. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 23:14, 10 May 2012 (CEST)

	== splitting into smaller articles ==		== splitting into smaller articles ==

@@ Line 32: / Line 32: @@
 # Advanced.  Hardware hacking, using an alternate OS, repairs, etc.
 &mdash; [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope|spiralofhope]] / <sup>[[User_Talk:Spiralofhope|(talk)]]</sup> 19:49, 22 February 2012 (CET)
 == Dangerous unsourced battery charging information ==

← Older revision		Revision as of 04:05, 25 February 2012
Line 42:		Line 42:

	Discharging batteries, putting them in the fridge etc.. is very old knowledge. This does not apply to new technologies. Suggesting this sort of thing is wrong unless we can get official statements talking about the battery technology and we can confirm from _proper_ sources that treating a battery in this manner is a good idea. "I read it somewhere" or "I've done this for years" are not good enough. Propagating crappy advice like that is akin to telling people to sleep with it under their pillows so the demons don't get at it. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 20:12, 22 February 2012 (CET)		Discharging batteries, putting them in the fridge etc.. is very old knowledge. This does not apply to new technologies. Suggesting this sort of thing is wrong unless we can get official statements talking about the battery technology and we can confirm from _proper_ sources that treating a battery in this manner is a good idea. "I read it somewhere" or "I've done this for years" are not good enough. Propagating crappy advice like that is akin to telling people to sleep with it under their pillows so the demons don't get at it. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 20:12, 22 February 2012 (CET)
		+	:Heh heh... a bit of an extreme example but you make a good point. The information here should be stuff you can rely on, not hearsay. [[User:Cheese\|Cheese]] 05:05, 25 February 2012 (CET)

← Older revision		Revision as of 19:12, 22 February 2012
Line 38:		Line 38:

	:There is now a [[Keyboard]] article. [[User:Esn\|Esn]] 00:31, 15 January 2011 (MET)		:There is now a [[Keyboard]] article. [[User:Esn\|Esn]] 00:31, 15 January 2011 (MET)
		+
		+	== Dangerous unsourced battery charging information ==
		+
		+	Discharging batteries, putting them in the fridge etc.. is very old knowledge. This does not apply to new technologies. Suggesting this sort of thing is wrong unless we can get official statements talking about the battery technology and we can confirm from _proper_ sources that treating a battery in this manner is a good idea. "I read it somewhere" or "I've done this for years" are not good enough. Propagating crappy advice like that is akin to telling people to sleep with it under their pillows so the demons don't get at it. — [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup> 20:12, 22 February 2012 (CET)

← Older revision		Revision as of 18:49, 22 February 2012
Line 23:		Line 23:

	::Actually, it might make sense to describe some of the other options that are available now, or at least mention them. There's a list in [[software projects]] - scroll down to "operating systems". [[User:Esn\|Esn]] 07:02, 23 April 2011 (MEST)		::Actually, it might make sense to describe some of the other options that are available now, or at least mention them. There's a list in [[software projects]] - scroll down to "operating systems". [[User:Esn\|Esn]] 07:02, 23 April 2011 (MEST)
		+
		+	----
		+
		+	I recommend the article be split into several parts:
		+	# Overview, information. Features, safety, warranty.
		+	# Setup. Storage, recharging, initial bootup.
		+	# Usage. Basic software stuff - how to get to the software. A software list. From here there could be links to the various home pages for any software that's included. No documentation should be made for "how to use Firefox", etc. Just point people to that project.
		+	# Advanced. Hardware hacking, using an alternate OS, repairs, etc.
		+	— [[Image:Spiralofhope-logo-016.png]] [[User:Spiralofhope\|spiralofhope]] / <sup>[[User_Talk:Spiralofhope\|(talk)]]</sup>

	== Keyboard Layout ==		== Keyboard Layout ==

@@ Line 20: / Line 20: @@
 :::OK, i nearly did an example, but I think i want more input from folks. I agree than PNDs need that Intro to PND page, but I'd go one step further and also create Intro to apps, which takes the existing apps section in toto, and is replaced by Apps come as PNDs, See these lists, Copy to the SD like this. That keeps the user guide as an absolute minimum, with no distractions about opkg and the nand filling up (which can then be better expanded on once there is a new page). Actually, the firmware section was badly out of date, so I used that as an example. --[[User:Tsh|Tsh]] 20:24, 19 July 2010 (MEST)
 :Would it be ok to you to outsource e.g. [[Minimenu]], [[XFCE]]? I'm not sure if this wouldn't interrupt the information flow :/ --[[User:ABC|ABC]] 17:08, 22 April 2011 (MEST)
-::I'm not sure. The whole "Basic use" section actually looks pretty concise to me as it is. But I think DO it might make sense to create separate articles for "minimenu" and "XFCE", so the wiki can provide more detailed info than can be provided inside another article such as this one. On the other hand the "configuration and customization" section is pretty XFCE-specific. It might make sense to move ALL XFCE-specific and minimenu-specific stuff to their own articles. But then this wouldn't really be a "user manual" as such.
+::I'm not sure. The whole "Basic use" section actually looks pretty concise to me as it is. But I DO think it might make sense to create separate articles for "minimenu" and "XFCE", so the wiki can provide more detailed info than can be provided inside another article such as this one. On the other hand, the "configuration and customization" section is pretty XFCE-specific. It might make sense to move ALL XFCE-specific and minimenu-specific stuff to their own articles. But then this wouldn't really be a "user manual" as such. So... I don't know.
 ::Actually, it might make sense to describe some of the other options that are available now, or at least mention them. There's a list in [[software projects]] - scroll down to "operating systems". [[User:Esn|Esn]] 07:02, 23 April 2011 (MEST)

@@ Line 19: / Line 19: @@
 ::I did do a bit more splitting up a while ago. I moved the PND section to it's own article, but I also added in a very short version of how to install software and what a PND is, with a link to the new PND page. Just sharing that as an example for one way to do it. --[[User:Cheese|Cheese]] 18:40, 19 July 2010 (MEST)
 :::OK, i nearly did an example, but I think i want more input from folks. I agree than PNDs need that Intro to PND page, but I'd go one step further and also create Intro to apps, which takes the existing apps section in toto, and is replaced by Apps come as PNDs, See these lists, Copy to the SD like this. That keeps the user guide as an absolute minimum, with no distractions about opkg and the nand filling up (which can then be better expanded on once there is a new page). Actually, the firmware section was badly out of date, so I used that as an example. --[[User:Tsh|Tsh]] 20:24, 19 July 2010 (MEST)
 == Keyboard Layout ==