GUI for documentation, good or bad?

shirish shirishag75 at gmail.com
Wed Oct 22 09:31:49 UTC 2008


Hi all,
 Have made the bug invalid but now need to know where and against what
should I file a bug for having a GUI based editor. I just made some
documentation at https://help.ubuntu.com/community/NetworkManager0.7
and some smallish observations as to how having a GUI-based editor
would be useful. (The documentation though, is far from complete)

a. Lot of needless time gets spent on knowing whether an image would
or would not work with the content.  What I did was uploading the
image, and then if it doesn't scale up or down depending on my feel
scaled the core image up & down and uploaded again.

So, in essence time wasted and generating much more I/O for data which
is perhaps not needed.

b. Look at https://help.ubuntu.com/community/NetworkManager0.7#Adding%20Wired%20connections

Specifically the bit about

sudo ifconfig -a  and the stuff given as well as

dmesg | grep eth

The results or the result given would be so much nicer if it was in
some sort of [CODE] matter [CODE] like we use in ubuntuforums or like
shown in http://www.htmldog.com/reference/htmltags/code/

This way the whole thing would be nicer and clearer. A


c. General polishing and formatting, this takes lot of time as each
time one needs to preview, see if works and then do adjustments and
preview again and so on & so forth. Again time is wasted and
unnecessary bandwidth (I/O) which could be saved is not being saved.
-- 
          Regards,
          Shirish Agarwal
  This email is licensed under http://creativecommons.org/licenses/by-nc/3.0/

065C 6D79 A68C E7EA 52B3  8D70 950D 53FB 729A 8B17




More information about the ubuntu-doc mailing list