Topic-Based Thoughts

Matthew Paul Thomas mpt at
Wed Feb 21 10:39:15 UTC 2007

On Feb 12, 2007, at 7:51 PM, Duncan Lithgow wrote:
> On Sun, 2007-02-11 at 12:41 +0000, Phil Bull wrote:
> ...
>>  * Currently, networking is contained in the Internet topic. I think
>> that it's probably going to be a big enough subject to have its own
>> topic, especially when considering wireless networking. Does anyone 
>> have any thoughts on this?

I think "Internet" should be "Internet and networking". Mac Help's 
equivalent section is called "Getting connected", which is cute, but 
lacks eyecatching keywords. Windows Vista Help has separate "Internet" 
and "Networking" sections, but many of the "Networking" topics are 
explicitly about connecting to the Internet, which I think demonstrates 
that the distinction isn't a good one.

> I tend to agree - I just tried to get wifi working in Feisty and it 
> took me quite a while to fine the relevant guide. I actually had to 
> search for 'wireless' to find it. 'Wifi' gave no results, which 
> suggests that the word wifi should be added to that guide somehow.
> ...

This is an example of why I want a <keywords> element in the Mallard 
help format -- for recording synonyms and other terms that people will 
search for even when they aren't in the help text itself.

Matthew Paul Thomas

More information about the ubuntu-doc mailing list