On contributing
Alexander Gladysh
While we're discussing the license and the format, please do not
forget that this project main purpose is the book.
We have a lot of good stuff listed here:
https://github.com/lua-cookbook/lua-cookbook/wiki/Table-of-Contents-Brainstorming
Let's create an actual list of chapters and articles from this. (We
already have a kind of list of chapters, but no lost of articles).
Note: when writing a list please don't try to think out "smart"
titles. Write what the article should be about. If it is several
sentences — fine.
Smart titles will come later, from authors. At this point the goal is
that everyone will understand what this all is about.
Alexander.
Humberto S. N. dos Anjos
steve donovan
<h.a...@gmail.com> wrote:
> Lua-wiki's LuaDirectory page already has a cookbook-like structure and seems
> quite thorough, with plenty of interesting articles already available.
> Wouldn't some rewriting, updating older bits, and fleshing out the articles
> provide all the content needed?
There's a lot of high-quality goodies in the wiki, thanks to the
efforts of people like David Manura who re-organize it.
I've been looking at the String Recipes
http://lua-users.org/wiki/StringRecipes and thinking it would make a
good article. Of course, this would be a kind of low-ego writing,
because I would be stringing together pearls to make a coherent
necklace.
The wiki tends not to preserve the names of original authors, which
can be tricky if tracing the 'intended' licence. With the Lua snippets
site http://snippets.luacode.org/ Jim and I were trying to make a home
for short pieces of code that were always accompanied by licence and
original submitter (not of course the same as 'author'). This is
another source of pearls for those wishing to make jewelry.
Another starting point is the unofficial faq (http://www.luafaq.org/)
- at least there the 'authorship' is not doubtful, but it contains
snippets authored by many different people. I would like to take some
of these topics and expand them into articles, but I'd like some
advice about what topics to work with.
A good article has to have the right balance between English and Lua,
no matter how self-explanatory the code may feel at the time.
steve d.