Difference between revisions of "Talk:User manual"

From Pandora Wiki
Jump to: navigation, search
(splitting into smaller articles)
(splitting into smaller articles)
Line 14: Line 14:
 
:The splitting out needs to be even more radical, I think. It seems this was written as the community's version of the printed user manual. if it is going to stay like that, it should be split into chapters, with better navigation (the page is much too big). As an alternative, some info should be removed (e.g. specifications are not useful to be insered inline here. I was initially wondering how we should use this page to link to other pages. At the moment, my best effort would be to provide with each heading a link to a a group documentation page, and introduce them at the start of this page. That way it becomes something short to read, and also provides one possible jump-off page into the main wiki. --[[User:Tsh|Tsh]] 13:26, 19 July 2010 (MEST)
 
:The splitting out needs to be even more radical, I think. It seems this was written as the community's version of the printed user manual. if it is going to stay like that, it should be split into chapters, with better navigation (the page is much too big). As an alternative, some info should be removed (e.g. specifications are not useful to be insered inline here. I was initially wondering how we should use this page to link to other pages. At the moment, my best effort would be to provide with each heading a link to a a group documentation page, and introduce them at the start of this page. That way it becomes something short to read, and also provides one possible jump-off page into the main wiki. --[[User:Tsh|Tsh]] 13:26, 19 July 2010 (MEST)
 
::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)
 
::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).
+
:::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 ==
 
== Keyboard Layout ==
  
 
An up to date default keyboard mapping would be good. I know L is shift, but how about R - and are there any extended key sequences for other languages implemented yet? I would add something, but have no data to work with...
 
An up to date default keyboard mapping would be good. I know L is shift, but how about R - and are there any extended key sequences for other languages implemented yet? I would add something, but have no data to work with...

Revision as of 18:24, 19 July 2010

Terminal Commands

I'm pondering whether to add job control into this section, or whether a seperate section would make sense. Eg, & to launch an app in the background, CTRL-Z to stop an app, bg and fg to background and foreground it. It's really handy. -- Gricey

Also, I put a (use with care) next to the killall command. Killall is fun for casual stuff, but you may end up killing more instances of something than you planned. A better way of doing it, though it isn't as fast, is to use ps with grep and kill the specific PID. You can also kill a process by PID from top by pressing k, although your process may not appear in the top list. -- Gricey


I question whether terminal commands should even be in the user manual. The only people who have any cause to be messing around with the CLI are those who already know what they're doing. A casual user might go for years without ever opening a terminal window. An in-depth explanation of terminal commands is a good thing to have somewhere on the wiki, but probably not in this section. All you are likely to do is frighten and confuse people with this information, which they will probably never need to use anyway. Chip 00:30, 7 January 2010 (MET)

splitting into smaller articles

I think it would be a good idea to split this huge page into smaller chunks. That way updating it might be more convenient.

I've moved the linux guide and minimenu configuration docs into their own pages.--Cheese 04:12, 28 June 2010 (MEST)
The splitting out needs to be even more radical, I think. It seems this was written as the community's version of the printed user manual. if it is going to stay like that, it should be split into chapters, with better navigation (the page is much too big). As an alternative, some info should be removed (e.g. specifications are not useful to be insered inline here. I was initially wondering how we should use this page to link to other pages. At the moment, my best effort would be to provide with each heading a link to a a group documentation page, and introduce them at the start of this page. That way it becomes something short to read, and also provides one possible jump-off page into the main wiki. --Tsh 13:26, 19 July 2010 (MEST)
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. --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. --Tsh 20:24, 19 July 2010 (MEST)

Keyboard Layout

An up to date default keyboard mapping would be good. I know L is shift, but how about R - and are there any extended key sequences for other languages implemented yet? I would add something, but have no data to work with...