Talk:Tutorials and documentation - Revision history

Cheese at 18:29, 22 July 2010

2010-07-22T18:29:23Z

Tsh at 10:01, 22 July 2010

2010-07-22T10:01:32Z

Cheese at 08:17, 22 July 2010

2010-07-22T08:17:14Z

Tsh: /* User/Dev split */

2010-07-20T17:19:20Z

‎User/Dev split

Cheese at 16:49, 20 July 2010

2010-07-20T16:49:48Z

Tsh: /* User/Dev split */ firmware - dev or wider?

2010-07-20T10:55:57Z

‎User/Dev split: firmware - dev or wider?

Cheese at 06:01, 20 July 2010

2010-07-20T06:01:46Z

Tsh: /* User/Dev split */

2010-07-19T11:05:49Z

‎User/Dev split

Cheese at 05:40, 17 July 2010

2010-07-17T05:40:16Z

Cheese: /* User/Dev split */

2010-07-17T04:41:16Z

‎User/Dev split

@@ Line 29: / Line 29: @@
 ::::::Well, the community made the wiki in the first place so a few people must have started it and now it's spread. I don't really see it being reversible at this point, but I'll try to prevent it further through my editing. How about if I see an opportunity then I'll change text that's improperly calling the OS firmware? --[[User:Cheese|Cheese]] 10:17, 22 July 2010 (MEST)
 :::::::I did have a quick search, and didn't see much that seemed very wrong - just something to try and keep in mind for future edits really? --[[User:Tsh|Tsh]] 12:01, 22 July 2010 (MEST)
 :I think we need a "set up" or "configuring" or maybe just an "intermediate" sort of section for some of the slightly more advanced, but not too advanced things. Or the topics which are aren't going to be of interest to everyone. For the pages describing how to set up things (like gps's), the linux guide, the USB reference page, stuff like that. Those are things I wouldn't consider too advanced and they're not going to be something every Pandora owner would want to look at. --[[User:Cheese|Cheese]] 10:17, 22 July 2010 (MEST)
 ::Agreed. Sort of difficult to name the category when it is nearly empty though. Maybe ''in depth guides''. It needs to not sound scary, but shouldn't be in the most obvious 'all users' list. We might also want to give some thought to splitting this into several pages. I already added some global (gui/audio) pages for the all users list. In depth guides could be a similar page. Be careful of making this too optimised at this point though, we should get a few more wiki editors when shipments resume. --[[User:Tsh|Tsh]] 12:01, 22 July 2010 (MEST)

@@ Line 28: / Line 28: @@
 :::::Extend is not firmware in my mind, it's a user topic (probably advanced, although that could change if it is stable). My point is we need a category that is what I class as firmware, making it too wide is just confusing. I think the community may have picked up some bad nomenclature from the wiki, so we could attempt to rescue that. Certainly the firmware topics can link to Extend where relevant because there is overlap in some areas. We could make the topic 'Firmware Development Topics' and see if there is a need for any other divisions. I did want really to avoid making the firmware section appear 'restricted', since there is scope for beta testing and such in there too.
 ::::::Well, the community made the wiki in the first place so a few people must have started it and now it's spread. I don't really see it being reversible at this point, but I'll try to prevent it further through my editing. How about if I see an opportunity then I'll change text that's improperly calling the OS firmware? --[[User:Cheese|Cheese]] 10:17, 22 July 2010 (MEST)
 :I think we need a "set up" or "configuring" or maybe just an "intermediate" sort of section for some of the slightly more advanced, but not too advanced things. Or the topics which are aren't going to be of interest to everyone. For the pages describing how to set up things (like gps's), the linux guide, the USB reference page, stuff like that. Those are things I wouldn't consider too advanced and they're not going to be something every Pandora owner would want to look at. --[[User:Cheese|Cheese]] 10:17, 22 July 2010 (MEST)

← Older revision		Revision as of 08:17, 22 July 2010
Line 27:		Line 27:
	::::I was thinking maybe the Extend utils page or the intro page. I do agree with you on the definition of firmware, but it seems like it's been unofficially defined by the community to also include the root filesystem. --[[User:Cheese\|Cheese]] 18:49, 20 July 2010 (MEST)		::::I was thinking maybe the Extend utils page or the intro page. I do agree with you on the definition of firmware, but it seems like it's been unofficially defined by the community to also include the root filesystem. --[[User:Cheese\|Cheese]] 18:49, 20 July 2010 (MEST)
	:::::Extend is not firmware in my mind, it's a user topic (probably advanced, although that could change if it is stable). My point is we need a category that is what I class as firmware, making it too wide is just confusing. I think the community may have picked up some bad nomenclature from the wiki, so we could attempt to rescue that. Certainly the firmware topics can link to Extend where relevant because there is overlap in some areas. We could make the topic 'Firmware Development Topics' and see if there is a need for any other divisions. I did want really to avoid making the firmware section appear 'restricted', since there is scope for beta testing and such in there too.		:::::Extend is not firmware in my mind, it's a user topic (probably advanced, although that could change if it is stable). My point is we need a category that is what I class as firmware, making it too wide is just confusing. I think the community may have picked up some bad nomenclature from the wiki, so we could attempt to rescue that. Certainly the firmware topics can link to Extend where relevant because there is overlap in some areas. We could make the topic 'Firmware Development Topics' and see if there is a need for any other divisions. I did want really to avoid making the firmware section appear 'restricted', since there is scope for beta testing and such in there too.
		+	::::::Well, the community made the wiki in the first place so a few people must have started it and now it's spread. I don't really see it being reversible at this point, but I'll try to prevent it further through my editing. How about if I see an opportunity then I'll change text that's improperly calling the OS firmware? --[[User:Cheese\|Cheese]] 10:17, 22 July 2010 (MEST)
		+
		+	:I think we need a "set up" or "configuring" or maybe just an "intermediate" sort of section for some of the slightly more advanced, but not too advanced things. Or the topics which are aren't going to be of interest to everyone. For the pages describing how to set up things (like gps's), the linux guide, the USB reference page, stuff like that. Those are things I wouldn't consider too advanced and they're not going to be something every Pandora owner would want to look at. --[[User:Cheese\|Cheese]] 10:17, 22 July 2010 (MEST)

← Older revision		Revision as of 17:19, 20 July 2010
Line 26:		Line 26:
	:::My view is that firmware is the package which gets pushed out by OpenPandora, so in terms of booting, it would include uBoot (the bootloader), but not the boot.txt files. It isn't the right area for 'how do I configure my filesystem/keymapping', but it is probably the right area for something like an alternative keyboard/nub driver. Firmware is more of a context than a component - so I think it is in the developer domain. What were you thinking of adding?--[[User:Tsh\|Tsh]] 12:55, 20 July 2010 (MEST)		:::My view is that firmware is the package which gets pushed out by OpenPandora, so in terms of booting, it would include uBoot (the bootloader), but not the boot.txt files. It isn't the right area for 'how do I configure my filesystem/keymapping', but it is probably the right area for something like an alternative keyboard/nub driver. Firmware is more of a context than a component - so I think it is in the developer domain. What were you thinking of adding?--[[User:Tsh\|Tsh]] 12:55, 20 July 2010 (MEST)
	::::I was thinking maybe the Extend utils page or the intro page. I do agree with you on the definition of firmware, but it seems like it's been unofficially defined by the community to also include the root filesystem. --[[User:Cheese\|Cheese]] 18:49, 20 July 2010 (MEST)		::::I was thinking maybe the Extend utils page or the intro page. I do agree with you on the definition of firmware, but it seems like it's been unofficially defined by the community to also include the root filesystem. --[[User:Cheese\|Cheese]] 18:49, 20 July 2010 (MEST)
		+	:::::Extend is not firmware in my mind, it's a user topic (probably advanced, although that could change if it is stable). My point is we need a category that is what I class as firmware, making it too wide is just confusing. I think the community may have picked up some bad nomenclature from the wiki, so we could attempt to rescue that. Certainly the firmware topics can link to Extend where relevant because there is overlap in some areas. We could make the topic 'Firmware Development Topics' and see if there is a need for any other divisions. I did want really to avoid making the firmware section appear 'restricted', since there is scope for beta testing and such in there too.

← Older revision		Revision as of 16:49, 20 July 2010
Line 25:		Line 25:
	::Is the firmware section going to be development only stuff? If not, I can see a couple things which could be listed there. --[[User:Cheese\|Cheese]] 08:01, 20 July 2010 (MEST)		::Is the firmware section going to be development only stuff? If not, I can see a couple things which could be listed there. --[[User:Cheese\|Cheese]] 08:01, 20 July 2010 (MEST)
	:::My view is that firmware is the package which gets pushed out by OpenPandora, so in terms of booting, it would include uBoot (the bootloader), but not the boot.txt files. It isn't the right area for 'how do I configure my filesystem/keymapping', but it is probably the right area for something like an alternative keyboard/nub driver. Firmware is more of a context than a component - so I think it is in the developer domain. What were you thinking of adding?--[[User:Tsh\|Tsh]] 12:55, 20 July 2010 (MEST)		:::My view is that firmware is the package which gets pushed out by OpenPandora, so in terms of booting, it would include uBoot (the bootloader), but not the boot.txt files. It isn't the right area for 'how do I configure my filesystem/keymapping', but it is probably the right area for something like an alternative keyboard/nub driver. Firmware is more of a context than a component - so I think it is in the developer domain. What were you thinking of adding?--[[User:Tsh\|Tsh]] 12:55, 20 July 2010 (MEST)
		+	::::I was thinking maybe the Extend utils page or the intro page. I do agree with you on the definition of firmware, but it seems like it's been unofficially defined by the community to also include the root filesystem. --[[User:Cheese\|Cheese]] 18:49, 20 July 2010 (MEST)

← Older revision		Revision as of 10:55, 20 July 2010
Line 24:		Line 24:
	:Troubleshooting gave me an idea for the wifi page, which is a 2nd level reference, pulling together everything we have on WiFi (plus we can keep direct links on this page where it makes sense, giving an easy route to a page for different people) --[[User:Tsh\|Tsh]] 13:05, 19 July 2010 (MEST)		:Troubleshooting gave me an idea for the wifi page, which is a 2nd level reference, pulling together everything we have on WiFi (plus we can keep direct links on this page where it makes sense, giving an easy route to a page for different people) --[[User:Tsh\|Tsh]] 13:05, 19 July 2010 (MEST)
	::Is the firmware section going to be development only stuff? If not, I can see a couple things which could be listed there. --[[User:Cheese\|Cheese]] 08:01, 20 July 2010 (MEST)		::Is the firmware section going to be development only stuff? If not, I can see a couple things which could be listed there. --[[User:Cheese\|Cheese]] 08:01, 20 July 2010 (MEST)
		+	:::My view is that firmware is the package which gets pushed out by OpenPandora, so in terms of booting, it would include uBoot (the bootloader), but not the boot.txt files. It isn't the right area for 'how do I configure my filesystem/keymapping', but it is probably the right area for something like an alternative keyboard/nub driver. Firmware is more of a context than a component - so I think it is in the developer domain. What were you thinking of adding?--[[User:Tsh\|Tsh]] 12:55, 20 July 2010 (MEST)

← Older revision		Revision as of 06:01, 20 July 2010
Line 23:		Line 23:
	:OK, you'll probably want to make some changes, but it's done. I put a link to [[Other resources]] which takes care of an orphaned page, but that page is actually so out of date it's nearly useless. The good stuff should can be moved to this page and that page removed. --[[User:Cheese\|Cheese]] 07:40, 17 July 2010 (MEST)		:OK, you'll probably want to make some changes, but it's done. I put a link to [[Other resources]] which takes care of an orphaned page, but that page is actually so out of date it's nearly useless. The good stuff should can be moved to this page and that page removed. --[[User:Cheese\|Cheese]] 07:40, 17 July 2010 (MEST)
	:Troubleshooting gave me an idea for the wifi page, which is a 2nd level reference, pulling together everything we have on WiFi (plus we can keep direct links on this page where it makes sense, giving an easy route to a page for different people) --[[User:Tsh\|Tsh]] 13:05, 19 July 2010 (MEST)		:Troubleshooting gave me an idea for the wifi page, which is a 2nd level reference, pulling together everything we have on WiFi (plus we can keep direct links on this page where it makes sense, giving an easy route to a page for different people) --[[User:Tsh\|Tsh]] 13:05, 19 July 2010 (MEST)
		+	::Is the firmware section going to be development only stuff? If not, I can see a couple things which could be listed there. --[[User:Cheese\|Cheese]] 08:01, 20 July 2010 (MEST)

← Older revision		Revision as of 11:05, 19 July 2010
Line 22:		Line 22:
	:Troubleshooting seems more deserving of a separate FAQ type page rather than a list. Going to try to reorganize this page now. --[[User:Cheese\|Cheese]] 06:41, 17 July 2010 (MEST)		:Troubleshooting seems more deserving of a separate FAQ type page rather than a list. Going to try to reorganize this page now. --[[User:Cheese\|Cheese]] 06:41, 17 July 2010 (MEST)
	:OK, you'll probably want to make some changes, but it's done. I put a link to [[Other resources]] which takes care of an orphaned page, but that page is actually so out of date it's nearly useless. The good stuff should can be moved to this page and that page removed. --[[User:Cheese\|Cheese]] 07:40, 17 July 2010 (MEST)		:OK, you'll probably want to make some changes, but it's done. I put a link to [[Other resources]] which takes care of an orphaned page, but that page is actually so out of date it's nearly useless. The good stuff should can be moved to this page and that page removed. --[[User:Cheese\|Cheese]] 07:40, 17 July 2010 (MEST)
		+	:Troubleshooting gave me an idea for the wifi page, which is a 2nd level reference, pulling together everything we have on WiFi (plus we can keep direct links on this page where it makes sense, giving an easy route to a page for different people) --[[User:Tsh\|Tsh]] 13:05, 19 July 2010 (MEST)

← Older revision		Revision as of 05:40, 17 July 2010
Line 21:		Line 21:
	:I like this idea, I was trying to come up with a better way to organize this stuff myself. The line between what's documentation and what's a tutorial isn't always clear enough. I don't know if you missed it, but on the Wiki TODO talk page I mentioned scrapping the [[InfoIndex]] page (well actually, merging it with [[Community Links]]) and then making tutorials and documentation the new information index. The page itself wouldn't really change it's purpose, it would just let us link to things which aren't quite tutorials or documentation, like a few of the orphaned pages. --[[User:Cheese\|Cheese]] 19:18, 16 July 2010 (MEST)		:I like this idea, I was trying to come up with a better way to organize this stuff myself. The line between what's documentation and what's a tutorial isn't always clear enough. I don't know if you missed it, but on the Wiki TODO talk page I mentioned scrapping the [[InfoIndex]] page (well actually, merging it with [[Community Links]]) and then making tutorials and documentation the new information index. The page itself wouldn't really change it's purpose, it would just let us link to things which aren't quite tutorials or documentation, like a few of the orphaned pages. --[[User:Cheese\|Cheese]] 19:18, 16 July 2010 (MEST)
	:Troubleshooting seems more deserving of a separate FAQ type page rather than a list. Going to try to reorganize this page now. --[[User:Cheese\|Cheese]] 06:41, 17 July 2010 (MEST)		:Troubleshooting seems more deserving of a separate FAQ type page rather than a list. Going to try to reorganize this page now. --[[User:Cheese\|Cheese]] 06:41, 17 July 2010 (MEST)
		+	:OK, you'll probably want to make some changes, but it's done. I put a link to [[Other resources]] which takes care of an orphaned page, but that page is actually so out of date it's nearly useless. The good stuff should can be moved to this page and that page removed. --[[User:Cheese\|Cheese]] 07:40, 17 July 2010 (MEST)

← Older revision		Revision as of 04:41, 17 July 2010
Line 20:		Line 20:

	:I like this idea, I was trying to come up with a better way to organize this stuff myself. The line between what's documentation and what's a tutorial isn't always clear enough. I don't know if you missed it, but on the Wiki TODO talk page I mentioned scrapping the [[InfoIndex]] page (well actually, merging it with [[Community Links]]) and then making tutorials and documentation the new information index. The page itself wouldn't really change it's purpose, it would just let us link to things which aren't quite tutorials or documentation, like a few of the orphaned pages. --[[User:Cheese\|Cheese]] 19:18, 16 July 2010 (MEST)		:I like this idea, I was trying to come up with a better way to organize this stuff myself. The line between what's documentation and what's a tutorial isn't always clear enough. I don't know if you missed it, but on the Wiki TODO talk page I mentioned scrapping the [[InfoIndex]] page (well actually, merging it with [[Community Links]]) and then making tutorials and documentation the new information index. The page itself wouldn't really change it's purpose, it would just let us link to things which aren't quite tutorials or documentation, like a few of the orphaned pages. --[[User:Cheese\|Cheese]] 19:18, 16 July 2010 (MEST)
		+	:Troubleshooting seems more deserving of a separate FAQ type page rather than a list. Going to try to reorganize this page now. --[[User:Cheese\|Cheese]] 06:41, 17 July 2010 (MEST)