Talk:TeX notation filter

Revision as of 20:16, 9 July 2010 by Colin Fraser (talk | contribs) (Documentation Issues)

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.0. Up-to-date documentation for the latest stable version is available here: TeX notation filter.

Documentation Issues

As noted in forums, and arguably as evidenced by posters,current TeX filter needs comprehensive documentation. Of course, an alternative is to replace it altogether Marc Grober 17:13, 28 May 2010 (UTC)

I would not disagree with you on either of those points Marc..:) To get some better documentation started, I am posting some of my own fumbling forays into the TeX filter in the hope that someone will be encouraged enough to make them better. In the meantime, the Introduction to this "A Tale of Two Filters" is confusing in itself - but this is a standard of the entire TeX world I suspect. One of the main issues I can see is that lot of experts have fallen in love with their own expertise and have forgotten that the people who are looking for information do not have that expertise - something we need to avoid here. I would also suggest that using such comments as "See Latex documentation.." are meaningless to most people. If you try and read it as a complete newbie, then you would understand why it is meaningless. --Colin Fraser 19:35, 8 July 2010 (UTC)

Also, are comments about Moodle 1.6 still relevant? Personally, I would suggest not and they will be made even more redundant when M2.0 hits the shelf. --Colin Fraser 19:59, 9 July 2010 (UTC)

Sorry to whomever wrote this and to other editors, but a lot of this does not make sense any more. To me, no-one has looked at this page for a while, and as the only listed comments in the history page come from Marc and myself, I am going to please myself and arbitrarily edit it. I am sure that someone else will come along at some stage in the future and say that what I have written is nonsense and will change it. Good for them. --Colin Fraser 20:16, 9 July 2010 (UTC)