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