Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-12 Thread Kyle Nitzsche
My two-cent perspective on this topic (again ;-): * In my opinion the overall trend is towards web-hosted help, for many reasons (of which I listed some at the start of this thread, but they include: easier for users to find content, easier for users to submit content, higher quality content

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-12 Thread Benjamin Humphrey
What Kyle has just listed below sums up the intentions of the Ubuntu Support and Learning Center perfectly - so perfectly, in fact, that I might just copy and paste his words onto the wiki page for it! This is the direction the manual team is heading in, no doubt about it. On Tue, Jul 13, 2010

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Jason Cook
I think that a cloud based solution is a great idea. But for mobile users this would a problem. One possible solution would be to include *all* of the content that is available online in a repository that *gets updated when the contents on the web changes*. Then is is not just static and can be

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Kyle Nitzsche
Hello Shaun and all. On 07/07/2010 07:34 PM, Shaun McCance wrote: On Wed, 2010-07-07 at 17:13 -0400, Kyle Nitzsche wrote: http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/ [snip] With which I agree in general. * on-disk docs might effectively

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Kyle Nitzsche
Hi Jason? On 07/09/2010 06:32 AM, Jason Cook wrote: I think that a cloud based solution is a great idea. But for mobile users this would a problem. Why do you think a web/cloud-based help system a problem for mobile users? One possible solution would be to include *all* of the content that

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Shaun McCance
On Fri, 2010-07-09 at 12:00 -0400, Kyle Nitzsche wrote: Hello Shaun and all. On 07/07/2010 07:34 PM, Shaun McCance wrote: A greater disconnect between applications and their help. Our traditional help consists of islands of documents that are largely separate from the applications they

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Jason Cook
The reason it may be a problem is that often when I don't have an internet connection, I need to know how to use an applications that have not yet learned how to use or am experiencing problems with. Though most are self-explanatory, some app are more complex and, when using this method, I can't

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Kyle Nitzsche
Hi Jim, On 07/09/2010 03:38 PM, Jim Campbell wrote: On Fri, Jul 9, 2010 at 1:50 PM, Jason Cook ja...@cookcrew.ca mailto:ja...@cookcrew.ca wrote: The reason it may be a problem is that often when I don't have an internet connection, I need to know how to use an applications that

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Jason Cook
The inclusion of on-disk documentation should be up to the user and be package-wide. Having a documentation package that has the documentation for all installed applications. The way this would work (at least in theory) is: - on instalation of this package - finds all installed packages

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Kyle Nitzsche
Hi Jason, On 07/09/2010 04:08 PM, Jason Cook wrote: The inclusion of on-disk documentation should be up to the user and be package-wide. Having a documentation package that has the documentation for all installed applications. The way this would work (at least in theory) is: * on

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Jason Cook
I defiantly agree that the *primary* development should be done on the web based content, *but* there should be a way to have the docs available offline. The way I recommended would work well, but would be *very* difficult. On Fri, Jul 9, 2010 at 4:30 PM, Kyle Nitzsche

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-09 Thread Phillip Whiteside
Hi, i'm still a bit puzzled (normal for me) Firefox Chromium Thunderbird FileZilla etc. All are programmes that require the net. What about AbiWord, Gnumeric, or even Open Office? As all installations of *buntu have a browser then imho, putting the most up to date wiki page on for that

[Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-07 Thread Kyle Nitzsche
http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/ Which includes this tantalizing paragraph: *Treat data as a service*. It’s no longer useful to package up documentation in order to provide local copies of it on every Linux system. The web is a much, much

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-07 Thread Christopher Vagnetoft
On Wed, Jul 7, 2010 at 11:13 PM, Kyle Nitzsche kyle.nitzs...@canonical.comwrote: So that is where I'd be putting my efforts at re-thinking docs: * how to start building the best web-based system possible (one that supports the Ubuntu ecosystem, including regular Ubuntu releases and Ubuntu

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-07 Thread Phillip Whiteside
Hi Naturally, there are disadvantages, such as: * no internet connection = no help (beyond the minimal on-disk help) * umm.. any other disadvantages? You missed out 1) people on narrow-band (as it is now called) for whom the https://shipit.ubuntu.com/ is their only hope 2) people paying per

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-07 Thread Shaun McCance
On Wed, 2010-07-07 at 17:13 -0400, Kyle Nitzsche wrote: http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/ [snip] With which I agree in general. * on-disk docs might effectively be limited to only what is necessary to get started and get connected to the web

Re: [Ubuntu-manual] An interesting blog by Matt Zimmerman touches on docs

2010-07-07 Thread Jim Campbell
Hi All, On Wed, Jul 7, 2010 at 6:34 PM, Shaun McCance sha...@gnome.org wrote: On Wed, 2010-07-07 at 17:13 -0400, Kyle Nitzsche wrote: http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/ [snip] With which I agree in general. * on-disk docs might