Improving the Internet docs

[Phil Bull]

Hi Matt,

On Mon, 2007-07-30 at 22:27 +0100, Matthew East wrote:
> I'd like to understand better the proposal. Are you suggesting having
> different topics on the front page of the help system, or just having
> different categories under the main heading of "Internet"? If the
> latter, I have no objections. If the former, I'd be very concerned about
> increasing the number of topics on the front page in the absence of a
> special justification to do so.

It's definitely the latter! Regarding the number of topics on the front
page, what do you think about removing 'Advanced Topics' and having a
new 'More topics...' link? This would give us a 'miscellaneous' section
which, while not ideal, would at least allow the other documentation to
be linked to.

> No one will object to improving this section, if we can. Unfortunately,
> it's really difficult - I looked at doing this in the last release
> cycle, and found that the support for modems in Ubuntu is so bad and
> that the instructions required are so dependent on individual modem
> models that it's actually prohibitive to do anything like a proper job
> on this.
> 
> The main problem with scanModem is that the script doesn't work properly
> for many modems (including mine), and the developers who I've talked to
> say that it's total crack.
> 
> The only thing I can suggest is to work with some of the developers who
> might be able to improve modem support in Ubuntu and do a joint prong
> attach - improving modem support and improving the documentation.
> Matthew Garrett is the first person to contact about this, I think.

I'll contact Matthew Garrett and see what he thinks. If it comes down to
it, we can always just ship the modem-specific docs hidden away
somewhere. It wouldn't be pretty, but it would be better than nothing :(

Thanks,

Phil

-- 
Phil Bull
http://www.launchpad.net/people/philbull