Hi<div><br></div><div><blockquote class="gmail_quote" style="margin-top: 0px; margin-right: 0px; margin-bottom: 0px; margin-left: 0.8ex; border-left-width: 1px; border-left-color: rgb(204, 204, 204); border-left-style: solid; padding-left: 1ex; ">
Naturally, there are disadvantages, such as:</blockquote><span class="Apple-style-span" style="font-family: arial, sans-serif; font-size: 13px; border-collapse: collapse; "><blockquote>* no internet connection = no help (beyond the minimal on-disk help)<br>
<span class="Apple-style-span" style="border-collapse: separate; font-family: arial; font-size: small; ">* umm.. any other disadvantages?</span></blockquote></span></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;"><br>
</span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">You missed out</span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;"><br>
</span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">1) people on narrow-band (as it is now called) for whom the </span></font><a href="https://shipit.ubuntu.com/">https://shipit.ubuntu.com/</a> is their only hope</div>
<meta http-equiv="content-type" content="text/html; charset=utf-8"><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse; ">2) people paying per byte</span></font></div>
<div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;"><br></span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">Don't let osabdfl hear that you are going to 'cut off' those areas of the world who are in that position.</span></font></div>
<div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;"><br></span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">Regards,</span></font></div>
<div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;"><br></span></font></div><div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">Phill.</span></font></div>
<div><font class="Apple-style-span" face="arial, sans-serif"><span class="Apple-style-span" style="border-collapse: collapse;">P.S., are we allowed to call him that? If not, sorry.<br></span></font><br><div class="gmail_quote">
On Wed, Jul 7, 2010 at 10:13 PM, Kyle Nitzsche <span dir="ltr"><<a href="mailto:kyle.nitzsche@canonical.com">kyle.nitzsche@canonical.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
<a href="http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/" target="_blank">http://mdzlog.alcor.net/2010/07/06/weve-packaged-all-of-the-free-software-what-now/</a><br>
<br>
Which includes this tantalizing paragraph:<br>
<br>
*"Treat data as a service*. It’s no longer useful to package up<br>
documentation in order to provide local copies of it on every Linux<br>
system. The web is a much, much richer and more effective solution to<br>
that problem. The same principle is increasingly applicable to<br>
structured data. From documents and contacts to anti-virus signatures<br>
and PCI IDs, there’s much better data to be had “out there” on the web<br>
than “down here” on the local filesystem."<br>
<br>
With which I agree in general.<br>
* on-disk docs might effectively be limited to only what is necessary to<br>
get started and get connected to the web (localized, of course).<br>
* run-time help links might instead display appropriate content in the<br>
browser.<br>
<br>
What are the advantages?<br>
* web functional richness offers numerous paths into content and many<br>
opportunities for sweet "eye-candy' design<br>
* periodically redesign web UI to bring freshness (instead of being<br>
"stuck" in same old rendered source format)<br>
* no "help viewer" dedicated app required (use browser)<br>
* content is more dynamic and flexible (no building packages and<br>
installing them) which means it's easier to fix errors and address key<br>
omissions<br>
* content can include (clearly labeled) user submissions in various<br>
formats: articles (reviewed and unreviewed), forums, wikis, which means<br>
official content undergoes obvious public review and feedback<br>
* in general it can provide a much easier-to-understand path for users<br>
to submit content<br>
* minimized disk footprint<br>
<br>
Naturally, there are disadvantages, such as:<br>
* no internet connection = no help (beyond the minimal on-disk help)<br>
* umm.. any other disadvantages?<br>
<br>
So that is where I'd be putting my efforts at re-thinking docs:<br>
* how to start building the best web-based system possible (one that<br>
supports the Ubuntu ecosystem, including regular Ubuntu releases and<br>
Ubuntu variants)<br>
* identifying the content that *must* be delivered as packages onto the<br>
disk (basically identifying the "Getting started/Getting Connected" and<br>
content)<br>
<br>
Cheers,<br>
Kyle<br>
<font color="#888888"><br>
<br>
<br>
<br>
--<br>
ubuntu-doc mailing list<br>
<a href="mailto:ubuntu-doc@lists.ubuntu.com">ubuntu-doc@lists.ubuntu.com</a><br>
<a href="https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc" target="_blank">https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc</a><br>
</font></blockquote></div><br></div>