discuss: Re: Beginning of outline for policies
Subject:
Re: Fwd: Beginning of outline for policies
From:
####@####.####
Date:
23 May 2002 04:10:24 -0000
Message-Id: <20020521220541.L14042@trib.com>
On Sun, May 19, 2002 at 10:00:40AM +0200, jdd wrote:
> I think this thread is pretty long, boring and disturbing.
>
> I dislike the "censorship" way it takes.
No-one has proposed censorship in any way. No-one is proposing to
prevent anyone from publishing anything elsewhere. There are proposals
that affect what the LDP will accept for publication. Every publishng
house in the world does that.
Censorship is a serious thing; ask any North Korean. Please do not
dilute the value of the word by misusing it.
>
> if the reviewer is so good as to be able to edit a HOWTO, why don't
> he write it himself? and if he is not what is he doing?
Writing, reviewing and editing are very different skills. they
compliment each other.
Writing involves imagination, organization skills, the abilites to do
research and to interview people, the ability to convey information
accurately and cocisely, and some familiarity with the subject. He
does not have to be expert in it. Often, a lack of expertese lets the
writer ask questions that someone in the field won't ask -- often
exactly the sort of questions the audience will ask. When I worked at
HP, I worked with a technical writer who described himself in his sig
line as a "computer information detective." I think that's a very good
description.
An editor should have some knowledge of the language and how it is
used to convey information. A technical editor has to have a good
grasp of the subject's argot.
A reviewer, as we are using the term here, should be technically aware
in the field under discussion, but need not know how to write or edit.
>
> I think it's possible to scan a doc fast for minimal correctness of
> langage and spell, thats all. this could barely take more than an
> hour.
That depends on the document and the level of quality desired. A good
technical editor may spend up to an hour per typeset page. I know;
I've gotten the bleeding corpses back from editors. :-)
>
> there are too much unsupported areas around. It should be better to
> write doc than search problems with authors.
The two are not mutually exclusive. In fact, a good writer seeks
editorial and reviewer correction. We are talking about technical
documentation here, and there is no place for big egos in the style of
overblown novelists or movie directors. If you have to get egoboo out
of technical writing, get it from the quality of the document, not
having your name on the title page.
> I don't know how you work, but for me I use more and more google to
> find solution and simply never read howtos from ldp (of course I
> find often them by google).
Er, then what are you doing here?
--
Charles Curley /"\ ASCII Ribbon Campaign
Looking for fine software \ / Respect for open standards
and/or web pages? X No HTML/RTF in email
http://w3.trib.com/~ccurley / \ No M$ Word docs in email
--> -->
<type 'exceptions.IOError'> | Python 2.5.2: /usr/bin/python Sat Jul 6 01:13:40 2024 |
A problem occurred in a Python script. Here is the sequence of
function calls leading up to the error, in the order they occurred.
/opt/ezmlm-browse-0.20/main.py in main() |
424
|
425 if path is not None:
|
426 main_path(path)
|
427 else:
|
428 main_form()
|
global main_form = <function main_form at 0xa1e6c6c> |
/opt/ezmlm-browse-0.20/main.py in main_form() |
378 except ImportError:
|
379 die(ctxt, "Invalid command")
|
380 module.do(ctxt)
|
381
|
382 def main():
|
module = <module 'commands.showmsg' from '/opt/ezmlm-browse-0.20/commands/showmsg.pyc'>, module.do = <function do at 0xa243224>, global ctxt = {'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'} |
/opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}) |
18 write(html('msg-pager') % ctxt)
|
19 write('<hr>')
|
20 sub_showmsg(ctxt, ctxt[MSGNUM])
|
21 write('<hr>')
|
22 write(html('msg-pager') % ctxt)
|
global sub_showmsg = <function sub_showmsg at 0xa1e61ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum' |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=3166) |
229 format_timestamp(ctxt, ctxt)
|
230 write(html('msg-header') % ctxt)
|
231 rec_showpart(ctxt, msg, 0)
|
232 write(html('msg-footer') % ctxt)
|
233 ctxt.pop()
|
global rec_showpart = <function rec_showpart at 0xa1e61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0xa25fe8c> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa25fe8c>, partnum=1) |
205 else:
|
206 for p in part.get_payload():
|
207 partnum = rec_showpart(ctxt, p, partnum+1)
|
208 else:
|
209 write(html('msg-sep') % ctxt)
|
partnum = 1, global rec_showpart = <function rec_showpart at 0xa1e61b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0xa25ffcc> |
/opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa25ffcc>, partnum=2) |
208 else:
|
209 write(html('msg-sep') % ctxt)
|
210 sub_showpart(ctxt, part)
|
211 return partnum
|
212
|
global sub_showpart = <function sub_showpart at 0xa1e6144>, ctxt = {'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0xa25ffcc> |
/opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 38, 'HTTP_X_FORW...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0xa25ffcc>) |
164 type = ctxt[TYPE] = part.get_content_type()
|
165 ctxt[FILENAME] = part.get_filename()
|
166 template = html('msg-' + type.replace('/', '-'))
|
167 if not template:
|
168 template = html('msg-' + type[:type.find('/')])
|
global template = <function template at 0xa1dee9c>, global html = <function html at 0xa1deed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0xa2628a8> |
/opt/ezmlm-browse-0.20/globalfns.py in html(name='msg-application-pgp-signature') |
40
|
41 def html(name):
|
42 return template(name + '.html')
|
43
|
44 def xml(name):
|
global template = <function template at 0xa1dee9c>, name = 'msg-application-pgp-signature' |
/opt/ezmlm-browse-0.20/globalfns.py in template(filename='msg-application-pgp-signature.html') |
31 except IOError:
|
32 if not _template_zipfile:
|
33 _template_zipfile = zipfile.ZipFile(sys.argv[0])
|
34 try:
|
35 f = _template_zipfile.open(n).read()
|
global _template_zipfile = None, global zipfile = <module 'zipfile' from '/usr/lib/python2.5/zipfile.pyc'>, zipfile.ZipFile = <class zipfile.ZipFile at 0xa177a7c>, global sys = <module 'sys' (built-in)>, sys.argv = ['-c', '/opt/ezmlm-browse-0.20'] |
/usr/lib/python2.5/zipfile.py in __init__(self=<zipfile.ZipFile instance at 0xa1f1bcc>, file='-c', mode='r', compression=0, allowZip64=False) |
337 self.filename = file
|
338 modeDict = {'r' : 'rb', 'w': 'wb', 'a' : 'r+b'}
|
339 self.fp = open(file, modeDict[mode])
|
340 else:
|
341 self._filePassed = 1
|
self = <zipfile.ZipFile instance at 0xa1f1bcc>, self.fp = None, builtin open = <built-in function open>, file = '-c', modeDict = {'a': 'r+b', 'r': 'rb', 'w': 'wb'}, mode = 'r' |
<type 'exceptions.IOError'>: [Errno 2] No such file or directory: '-c'
args =
(2, 'No such file or directory')
errno =
2
filename =
'-c'
message =
''
strerror =
'No such file or directory'