Bug 245357 - No manual
Summary: No manual
Status: RESOLVED DUPLICATE of bug 231613
Alias: None
Product: Network Management
Classification: Miscellaneous
Component: Control Module (show other bugs)
Version: 0.9
Platform: openSUSE Linux
: NOR normal
Target Milestone: ---
Assignee: Will Stephenson
URL:
Keywords:
: 246951 (view as bug list)
Depends on:
Blocks:
 
Reported: 2010-07-21 21:21 UTC by Christopher Yeleighton
Modified: 2016-06-16 08:38 UTC (History)
4 users (show)

See Also:
Latest Commit:
Version Fixed In:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Christopher Yeleighton 2010-07-21 21:21:11 UTC
Version:           0.9 (using KDE 4.3.5) 
OS:                Linux

The manual for kcm_networkmanagement does not exist

Reproducible: Always

Steps to Reproduce:
1. Open Network Connections control panel.
2. Press the Help button beneath.

Actual Results:  
2. Nothing happens.

Expected Results:  
2. The corresponding manual.
Comment 1 Burkhard Lück 2010-07-22 09:11:40 UTC
KNetworkmanager really needs a manual, and I offer any help from the docbook side to write one.
Networking is very complicated, my knowledge of that is limited, so without technical input from devels it is impossible for me to write a manual.

This manual should have several chapters:

* A glossar with a short explanation of all these "strange" terms used in the gui, I am sure Joe User does only understand less than half of them. And without a minimum understanding of the meaning of these term he is unable to use that module

* Quickstart
Just the minimum - and typical- settings needed for any possible type of connection
Using the plasma applet

* Advanced
Use cases for all these settings
Managed / unmanaged connetction
Relation to /etc/network/interfaces (do I need that any more / concflicts)
Troubleshooting eg
why do the settings in /var/lib/NetworkManager/NetworkManager.state sometimes seem to change magically?
Comment 2 Burkhard Lück 2010-08-07 09:25:15 UTC
*** Bug 246951 has been marked as a duplicate of this bug. ***
Comment 3 Lamarque V. Souza 2011-07-07 21:30:42 UTC

*** This bug has been marked as a duplicate of bug 231613 ***
Comment 4 Jan Kropik 2016-06-16 08:38:14 UTC
Yeah and list of regular Expressions used and how the programmer use and understand them, it is proof that this was and is always a problem in interdisciplinary routines.

Not any Joe User is patient enough to read the Full Versions before trying.
Learning is easier while doing stuff, 

And a Link to the Online Material Coders for their self used as Reference 
or a proper List of that.  Who wants to learn only the unnecessary Special Knowledge? 
or is able to that.

explaining complicate things into the Blue Sky is a little disturbing. 
So user will forgive missing Helps... but will continue stupid asking.