[prev in list] [next in list] [prev in thread] [next in thread] 

List:       lua-l
Subject:    Re: Getting Started with Lua
From:       marbux <marbux () gmail ! com>
Date:       2013-07-20 2:49:27
Message-ID: CAJ1g4g9fsqE6XGRE2E9kN-6Efa6zzgo4iu800DwPDRkA6-6cwg () mail ! gmail ! com
[Download RAW message or body]

On Fri, Jul 19, 2013 at 6:57 AM, Jay Carlson <nop@nop.com> wrote:

> The cheapest thing I can think of is to link to the lua-users wiki from
> each segment of the lua.org online manuals. "The wiki may have more
> information on string.gsub." I don't know if this would be used, but it
> incurs little cost or commitment at the lua.org side. Indexing into PiL
> is more difficult for a number of reasons, unfortunately.
>

I suggested something similar a few months ago. It differed mainly in that
in my concept, it would not be the main Reference Manual, but a copy that
could be annotated, perhaps best done with each manual section a separate
page that allows moderated comments. The hardest part I foresee is
transferring the comments when a new 0.1 Lua release arrives with a new
manual.

I do not doubt that the Reference Manual is great for those who are
experienced programmer's in some other language(s). But it's not so great
for those with no or only moderate programming experience (I fit in that
category when I first got acquainted with Lua). That's the target audience
I see as being most helped by an annotated version of the manual that has
links to related wiki pages, etc.

Luiz, I think the page is an excellent beginning. It might be embellished
with a link to wiki's directory page, <
http://lua-users.org/wiki/LuaDirectory>, which has the first link entitled
"Learning Lua."

I was also going to suggest linking the Embedding section to a
corresponding wiki page, but I didn't find one. Does anyone know of such a
page somewhere?

Best regards,

Paul

[Attachment #3 (text/html)]

<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, \
Jul 19, 2013 at 6:57 AM, Jay Carlson <span dir="ltr">&lt;<a href="mailto:nop@nop.com" \
target="_blank">nop@nop.com</a>&gt;</span> wrote:<br> <blockquote class="gmail_quote" \
style="margin:0px 0px 0px \
0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><p \
dir="ltr">The cheapest thing I can think of is to link to the lua-users wiki from \
each segment of the <a href="http://lua.org" target="_blank">lua.org</a> online \
manuals. &quot;The wiki may have more information on string.gsub.&quot; I don&#39;t \
know if this would be used, but it incurs little cost or commitment at the <a \
href="http://lua.org" target="_blank">lua.org</a> side. Indexing into PiL is more \
difficult for a number of reasons, unfortunately.</p> \
</blockquote><div><br></div><div>I suggested something similar a few months ago. It \
differed mainly in that in my concept, it would not be the main Reference Manual, but \
a copy that could be annotated, perhaps best done with each manual section a separate \
page that allows moderated comments. The hardest part I foresee is transferring the \
comments when a new 0.1 Lua release arrives with a new manual.  </div> \
<div><br></div><div>I do not doubt that the Reference Manual is great for those who \
are experienced programmer&#39;s in some other language(s). But it&#39;s not so great \
for those with no or only moderate programming experience (I fit in that category \
when I first got acquainted with Lua). That&#39;s the target audience I see as being \
most helped by an annotated version of the manual that has links to related wiki \
pages, etc.     </div> <div><br></div><div>Luiz, I think the page is an excellent \
beginning. It might be embellished with a link to wiki&#39;s directory page, &lt;<a \
href="http://lua-users.org/wiki/LuaDirectory">http://lua-users.org/wiki/LuaDirectory</a>&gt;, \
which has the first link entitled &quot;Learning Lua.&quot;  </div> \
<div><br></div><div>I was also going to suggest linking the Embedding section to a \
corresponding wiki page, but I didn&#39;t find one. Does anyone know of such a page \
somewhere?  </div><div><br></div><div>Best regards,</div> \
<div><br></div><div>Paul</div><div><br></div><div><br></div><div><br></div><div>  \
</div><div><br></div><div><br></div></div> </div></div>



[prev in list] [next in list] [prev in thread] [next in thread]