[q2x] OT: Lua questions

[Brian Hook]

> Have you read the papers on Lua? 

Which ones, the 7 year old DDJ papers?  Or the four year old random 
symposium presentations? =P

> agree that there are no docs and they have spent no time on docs.

The book is, granted, a monumental effort, but it's taken them to 
revision five to get it out.  

I'm not saying they are obligated to provide documentation, but 
adoption right now is at a much lower rate than it would be simply 
because all help has to be done through lua-l.

And the problem with that is that lua-l is now mostly experts like 
you, Thatcher, etc. and so when I get on there, I feel like a fucking 
dumbass asking questions.

> The docs for Lua are very concise and excellent. 

haha.  "Concise", is that we call it now? =)

The reference manual is woefully lacking in documentation on even the 
most basic aspects of stuff.  It took me forever how to do table 
iteration, and most of it was just guessing on my part because huge 
gaps are there.

> excellent work. One of the first things I look for in a software
> project is decent documentation also. 

To me it ALL starts with the documentation, because that shows me how 
interested the developers are in getting other people on board.  I've 
seen open source projects that effectively just say "read the headers, 
if you're good, you'll figure it out".  And they can kiss my ass =)

The complete lack of comments in the Lua source code sure as shit 
doesn't help their cause much either.

> AFAIK my wiki docs are the
> most complete syntax introduction. 

Yes, they are, and you've done a great job, but I feel bad that the 
onus has fallen on you for this.  can you imagine what the situation 
would be like if you weren't doing that?

Brian