Script Only Stack Architecture

[Richard Gaskin]

Kay C Lan wrote:

 > On Fri, Apr 1, 2016 at 9:43 AM, Richard Gaskin wrote:
 >>
 >> That's precisely why I advocate maintaining the Dictionary as
 >> an essential reference (as in "essence"); it should be easy
 >> to link to relevant tutorials and guides for more complete
 >> discussion when desired.
 >>
 > Could you give me an example of a Dictionary entry that has a link
 > to a Guide or Tutorial?

So many things in my life would be much simpler if "advocate" meant the 
same as "have been given authority and resources to have done it".

But unfortunately my world is not so simple. :)

So in short, "not yet".


 > Would they just be included in the Reference Tag or as a basic html
 > link to Tutorials?

Matt's request (in keeping with many others') is that we try to avoid 
requiring users to go to a generic Search or index to find things, that 
we "put the information where they need it", and I've wholeheartedly agreed.

To support that I would advocate that such links would be included 
directly in the Markdown of relevant Dictionary entries.

As for the alternative, in v8 I believe all tutorials and guides are 
already listed in the Help index, no?


 > Whilst I agree with you in principle, and that is certainly the
 > destination we need to be headed

Glad to hear it.  Peter Brett and I have some similar ideas about how to 
take advantage of the new docs format, now that the team has completed 
the considerable task of converting everything to Markdown.  If you like 
that idea I'm sure you'll like many of Peter's even more.


 > at this point in time I've got to agree with Matt.

As I have.  I've very explicitly and repeatedly encouraged people here 
to have exactly what they want by making it so:

    As I've noted here before, this blog post offers some helpful
    guidance for community members to get started contributing to
    the documentation to make it more of they want:
    <https://livecode.com/putting-the-you-in-documentation/>

The only place Matt and I disagree is the suggestion that I write it.

My work with LC is as a volunteer, not an employee.  And since my own 
experience has me inclined to try to meet the need expressed in this 
thread through different means, I'm not able to guess what other people 
may find ideal for this.

In short, I have neither the time nor talent to do what's been requested 
of me.

But I have encouraged others to do so.  And I continue to believe that 
adding whatever notes to a Dictionary entry one feels will prevent a 
similar question from coming up in the future is best done by doing it, 
or at least submitting it as an enhancement request to the bug queue for 
someone else to do, as opposed to just writing it here in a mailing list 
where it's almost guaranteed to be forgotten.

-- 
  Richard Gaskin
  Fourth World Systems
  Software Design and Development for the Desktop, Mobile, and the Web
  ____________________________________________________________________
  Ambassador at FourthWorld.com                http://www.FourthWorld.com