Subject:
Re: Linux Model is Unix model ? So where's TLDP ?
From:
Emma Jane Hogbin ####@####.####
Date:
8 Mar 2005 05:53:38 -0000
Message-Id: <20050308055358.GB6839@smeagol>
On Mon, Mar 07, 2005 at 06:58:02PM +0100, Mathieu Deschamps wrote:
> On Mon, Mar 07, 2005 at 04:17:52PM +0100, Mathieu Deschamps wrote:
> > + Programmers like documentation (eg. it help coding), one day a programmer +implements something new. He reminds to write doc. in order to share the vision, but +mostly he wants other fellows to pick up his work
>
> In general, most of the authors I've worked with on this project
> are not programmers. They are documentation authors, or people who have
> had a specific problem using a specific piece of software and have decided
> to share their documents with a larger audience. Many are new to writing
> documentation. Some "expert" authors think they are too clever to read
> the full Author Guide. This is fine. Some "new" authors think they are too
> clever to read the full Author Guide as well. However, I also get many
> compliments on the Guide, so I guess some people are clever enough to scan
> through the table of contents and read the parts that are interesting to
> them.
>
>
> * I'am sorry to see you pick my answer to attack me personnally.
OI! Not a single word in there was a personal attack on **you.** I'm sorry
that you were offended by what I said. If you are not someone who likes to
read long documents to begin with then I am not surprised that you don't
like the Author Guide. It is designed for people who like to read a lot of
text (typically this is about 1/4-1/3 of my students the rest do not like
to read long pieces like the Author Guide). I'm not defending The Guide.
To me it doesn't matter if you don't like it because I know it is not
perfect for everyone. This is why David has written a shorter document
that is a summary of the longer guide (not published yet because of
errors that need to be corrected).
> I spent 8 months changing The Author Guide so that it would make sense to
> people like me. I *like* reading technical documentation. Ask any of my
> friends in real life and they will tell you that I do not read fiction.
> I have received a number of compliments on the revised Author Guide, so
> clearly it is good for SOME learning styles. It is not perfect for ALL
> learning styles. I am not offended if it does not work for you. You do
> not like to read long documents in a language you are not familiar with.
>
> * Pick me on my language as long as you want, this does even not touch me, you know english is derivated in many dialect,
Again, I am *not* picking on you! I am trying to emphasize and say that it
IS difficult to read long passages in a language that is not familiar.
This is not an insult! You have misunderstood the intention of my words.
I am sorry, but I really am not trying to insult you, you are
reading into my words something that is not there.
Ca fait plus de dix annees que je prends les etudes en Francais. J'etais
mieux dans les discours d'oratoire--une domaine ou j'ai gagnee plusieurs
competitions; la langue ecrit, n'a j'aimais ete une de mes fortitude. Meme
maintenant, je lis en Anglais avec une dictionnaire. Je comprends mieux
les histoires et les "systemes" que je comprends chaque mot. Demands a
Guylhem--il te dira que mon accent est acceptable mais mon vocabulaire est
merde. Ce n'est pas une insult, c'est just moi. :)
[It has been more than ten years since I studied French. My strong suit
was always the spoken word--a discipline where I've won several awards;
the written language, however, has never been my strength. I still read
English with a dictionary even though it is my native language. I
understand the "story" more than I understand any individual word. Ask
Guylhem, he'll tell you my French accent is acceptable, but my vocabulary
is shite. It's not an insult, it's just me. :)]
> Finally, shouting at me woudn't make anything going better.
Again, ask Guylhem, it's just what I'm like in real life. I'm very
excitable. Eh, Guylhem? ;) I'm loud when I'm happy, and I laugh out loud
from the bottom of my belly. No reason to take offense. I type like I speak.
> *Really ? you refuse doc because it is unfinished ? So what are the revision for ? When a doc is said finished ? Look, that doesn't stand still...
In the publishing world a manuscript is accepted when the author feels
that it is absolutely the final draft with no factual mistakes and no
spelling errors. That is similar to what we do here. When an author feels
that their document is as far as they can possibly take it on their own,
the post it here for a "Peer Review":
http://www.tldp.org/HOWTO/LDP-Reviewer-HOWTO/peerreview.html
If the discuss lists finds no errors in the document, and there are no
major problems (with regard to copyright or duplication with the existing
documents in the collection), then the document is accepted to the
collection and begins the review process with a select number of people.
Three reviews are done:
Technical Review (looks for factual errors):
http://www.tldp.org/HOWTO/LDP-Reviewer-HOWTO/techreview.html
Language Review (looks for grammatical/spelling and document logic):
http://www.tldp.org/HOWTO/LDP-Reviewer-HOWTO/languagereview.html
Metadata Review (makes sure the document is correctly marked up and has
a license and other metadata things):
http://www.tldp.org/HOWTO/LDP-Reviewer-HOWTO/metadatareview.html
The Technical and Language Review typically require several revisions.
After all three reviews have been completed, and the changes requested
have been made, the document is published into the collection and
distributed on our web site and approximately 220 mirrors around the
world.
> * Really ? How lucky are ! Lucky I mean talented, this must be an interesting job. I'am not bad as well, you must admit this. Don't even believe I put your talent in question, I surely have lot to learn for people like you. I can assume you are far more expercienced than I. In fact, you surely accumulate more awards than I do. But every single remarks in my threads is a result of seasoned-methods aiming to ameliorate the service of TLDP. As I already said LDP is more that a doc. dispenser but it is set as it is. It need more volonteer but they never been so low. From your word you said it's perfect for all the learning style,
No. I said that it was *not* perfect for all the learning styles. I said
that long documents will only accommodate a small number of people. Every
student that I get in my full time class at college is required to do a
learning styles indicator (I use a modified Kolb test that takes about 20
minutes). Very few of my students are "book" learners. Most learn best by
doing activities, or listening to lecture or watching demonstrations. For
many of my students most of the documents in the LDP collection would be
of little to no use because they are not directed at active learning (Paulo
Freire).
If you are interested in helping with the project, that would be great.
I'm sure that your experience would be a valuable asset to our community.
thanks,
emma
--
Emma Jane Hogbin
I18N Coordinator, The Linux Documentation Project
www.tldp.org
--> -->
<type 'exceptions.IOError'> | Python 2.5.2: /usr/bin/python
Wed Jul 3 15:05:58 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 0x89cdc6c> |
| /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 0x89ea48c>, global ctxt = {'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'} |
| /opt/ezmlm-browse-0.20/commands/showmsg.py in do(ctxt={'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...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 0x89cd1ec>, ctxt = {'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, global MSGNUM = 'msgnum' |
| /opt/ezmlm-browse-0.20/globalfns.py in sub_showmsg(ctxt={'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msgnum=8827) |
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 0x89cd1b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, msg = <email.message.Message instance at 0x8a42c4c> |
| /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8a42c4c>, 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 0x89cd1b4>, ctxt = {'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, p = <email.message.Message instance at 0x8a42eac> |
| /opt/ezmlm-browse-0.20/globalfns.py in rec_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8a42eac>, 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 0x89cd144>, ctxt = {'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part = <email.message.Message instance at 0x8a42eac> |
| /opt/ezmlm-browse-0.20/globalfns.py in sub_showpart(ctxt={'cmd': 'showmsg', 'threadidx': 7, 'HTTP_X_FORWA...HTTP_ACCEPT_ENCODING': 'gzip, br, zstd, deflate'}, part=<email.message.Message instance at 0x8a42eac>) |
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 0x89c5e9c>, global html = <function html at 0x89c5ed4>, type = 'application/pgp-signature', type.replace = <built-in method replace of str object at 0x8a45bb8> |
| /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 0x89c5e9c>, 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 0x895ea7c>, 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 0x8a2898c>, 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 0x8a2898c>, 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'
