Re: [Proposal] Simplified Lua Reference

[Marcus Mason <m4gicks@...>]

I do not mean this to sound rude in any way but the reference manual is for people who understand programming. A lot of the content is very technical and this is why there are other resources such as Programming in Lua available for people who want to learn the language. Perhaps a modernization of some of lua's resources like the wiki could help ease newer people into understanding / learning the syntax more easily.

On Sun, Sep 20, 2020 at 5:24 PM Soni "They/Them" L. <fakedme@gmail.com> wrote:

The Lua reference manual includes things like BNF everywhere and some
stuff like "they can be used to represent ordinary arrays, lists, symbol
tables, sets, records, graphs, trees, etc."

It seems like a good idea to have a reference manual that translates the
BNF to english in a way that's easy for someone who doesn't know
programming to understand, and maybe omits things like the above, as
they add unnecessary complexity.

And arguably the stuff like "they can be used to represent ordinary
arrays, lists, symbol tables, sets, records, graphs, trees, etc." isn't
a good fit for a reference manual anyway, but mainly this is about the BNF.