[Doc-SIG] a wish list Part II

Manuel Gutierrez Algaba Manuel Gutierrez Algaba <irmina@ctv.es>
Sat, 6 Nov 1999 14:46:20 +0000 (GMT)


The method described in TeEncontreX is so extremely simple and 
flexible that:
a) You can take (rigth now) FAQ's and other document, 
attribute them just placing into them commands like
 \newcommand{\indexsockets}{\index{sockets}}...
b) You can mix FAQ's, article, example code... and even you
can distinguish them! Attributing:
\newcommand{\indexarticle}{\index{article}}
c) You can do that a kind of library of available rutines for 
python
d) You can extract data from .py. Ex:

class any_sockets_related_class:
    ...
    def cool_routine(self,...):
        """ \indexsockets \indexacoolthingX
        """

And parse it. 

Now, what we need for get the BEST and MOST powerful and cohesive
system of information is just  some hundreds of
 "ATTRIBUTERS"
(people who attribute ), no special need nor knoweledge is need.
And the effort is minimum ( write down three or four words,
here and there). It's a huge effort, but it's a linear effort and
simply straight forward.
Besides the attributed information can be rearraged many ways,
grouping the attributes... 

The more I think about it the more genial it seems to me. 

Just a question for the reader: Why is not implemented? 
The code is already done. It's simple, it's easy,it's high level...
It's a huge effort but, with 100 persons working at it, or 1000
persons working from time to time ( once a week , half an hour)
we could get thousand of attributed ( reusable, searchable, efficient...
) information. 
I, myself, have done a lot of in TeEncontreX, and It's me alone. 
One person 130 articles, 100 persons 13000 articles. And python
stuff is quite more readable that TeX stuff.

Regards/Saludos
Manolo
-------------
My addresses / mis direcciones: 
a="www.ctv.es/USERS/irmina"
b=[("Lritaunas Peki Project", ""),
   ("Spanish users of LaTeX(en Espanyol)", "/pyttex.htm" ),
   ("page of drawing utility for tex ", "/texpython.htm" ),
   ("CrossWordsLand","/cruo/cruo.html")
   ]
for i in b:
  print i[0],":", a+i[1]

  Waste not fresh tears over old griefs. -- Euripides