Internet documentation for Jaunty – help!

Documentation string freeze is rapidly approaching (March 26th) and I’ve not managed to get as much feedback on NetworkManager as I would have liked in order to make some really useful documentation.

Connection is one of those things that if a new user hits it, it can be a major problem – especially when so much help is available on the Internet! This often results in frustrated users who can only look to the little blue circle with the question mark.

The thing is though, I’m to blame too. I know how to troubleshoot networking problems, so it’s unlikely that I approach the problem from the same aspect as a newcomer, so might be answering a question that no-one asked!

With only two of NetworkManager’s currently supported connections – the documentation is lacking in three areas: VPN, DSL and the one I’m most worried about, Mobile Internet. I’d also love to reach more of a consensus on how to document dial-up connections.

So, now I’ve got a feed to Planet Ubuntu, I can hit a much wider audience and who are likely to have overcome any issues they encountered.

I need your experiences connecting using NM:

  • Which of NM’s connection types do you use?
  • Was it detected automatically?
  • Did you need to take any steps that are not apparent from the interface – such as installing extra packages or manually configuring options?

11 Replies to “Internet documentation for Jaunty – help!”

  1. I would be glad to put some doc in for network-manager-vpnc. There are some tricks (bugs?) that would initially trip somebody up depending on how their VPN is setup.

  2. Mobile internet with my nokia 6300 connected by usb worked wonderfully! Just a few clear steps to get connected.

  3. * Which of NM’s connection types do you use?
    Both ethernet and wireless connections used.

    * Was it detected automatically?
    Ethernet automatically detected and connected. Wireless required me to understand the encryption and key for my router, but apart from that it connected and continues to connect every time I start without ethernet connection at home. it has also connected to another wireless connection without drama. Ethernet also works in hotel.

    * Did you need to take any steps that are not apparent from the interface – such as installing extra packages or manually configuring options?
    No. All just worked as advertised. 🙂
    [Lenovo – T61]

  4. The current trunk is on the web at http://doc.ubuntu.com/ubuntu/internet/C/index.html

    I’ve got a mobile internet connection and it works great out of the box so I’ll double check the instructions in due course.

    VPN really confuses me – all the boxes are greyed out in network manager under this tab when I click “Configure VPN”. It’s only since the first comment in this blog post that I’ve become aware that you actually have to install a package!!! We certainly need to include that information in the docs.

Comments are closed.