Extension:Scribunto/Brainstorming

Brainstorming!


 * Re-evaluate use of templatelinks table to track module invocations
 * Feels kind of hackish; templatelinks table was never intended for this
 * Requires splitting every list of transcluded templates
 * Binary tracking (can't count invocations per page, e.g.)
 * Magic words... other breakage
 * Memory usage
 * Debugging tools
 * Track execution time
 * Track number of module invocations
 * Dedicated Special page? Special:LuaConsole or Special:Scribunto or something?
 * Style guide needed!
 * Split up reference manual into subpages (pagination!) and transclude onto a single page for single-page edition
 * Basic (side-by-side) comparison to ParserFunctions needed!
 * Explain how Module namespace fits into equation—it's an abstraction layer!
 * Link line number in error messages
 * Error messages are too confusing? &lt;eof&gt;?
 * CodeEditor tab key behavior...
 * It uses spaces instead of tabs for indentation
 * 39649 – CodeEditor extension's tab key behavior is slightly infuriating
 * Limit module invocation to Template namespace?
 * Trim lines that contain only spaces or tabs?
 * Module redirects?
 * Redirects and moves are both supported; only issue is rendering the redirect when &redirect=no is specified. This bug is mostly a sub-bug of the limiting syntax highlighting issue.
 * Tooltips for labeling/annotating code
 * Native capability for labeling/annotating lines of code? Unclear what level of benefit this would be.
 * Full comments fuck up the signal to noise ratio and make reading the code difficult. Tooltips work around this. Tooltips also suck without hover capability.
 * Tooltips could contain definitions of particular keywords/lines or they could contain plain English explanations of the code.
 * Track require calls in the templatelinks table?
 * Unicode + native functions such as string.len, string.reverse, etc.
 * "Script error" is not obviously a link
 * CSS to make it look like a button
 * Actual HTML submit button with some JS hijacking
 * Change link text to say "script error (click for details)" or something similarly obvious
 * When you file a bug, there's now a Lua option and a Scribunto option; as Scribunto becomes more popular, people will mis-file bugs
 * NOTE THAT SCRIBUNTO.WMFLABS.ORG IS USING A DIFFERENT VERSION OF SCRIBUNTO
 * Built-in modules can be syntax highlighted (e.g., ustring)?
 * GeSHi bug, I imagine
 * Better document how to dump functions from a Lua module
 * for name, func in pairs(string) do print (name) end
 * "How do I learn more about a Lua module?"
 * Does Lua have an equiavlent to Python's help for its modules?
 * Autodocs?
 * Autodocs?
 * Documentation system of some kind... from the code?
 * Long doc comments increase signal-to-noise ratio; mountains of grey text... bleh
 * Versioning of modules???
 * How do you mitigate the "forking effect" when interfaces change irreversibly?
 * Allow variants in name?
 * Would allowing a user to specify the module version provide more stability or make everything awful?
 * Some sort of native Unicode support, as opposed to packing UTF-8 into Lua's native bytestrings, would probably be desirable.
 * There seems to currently be a  construct, à la Python, added into Scribunto's version of Lua.
 * However, a syntax addition like this would likely break syntax highlighters and other static analysis tools.
 * Also, this may end up making Scribunto Lua code snippets differ significantly from vanilla Lua, making it harder to share code and more formidable for beginners.
 * Perhaps make Unicode strings the default, and dispense with bytestrings altogether? They're not particularly useful in text processing, are they?
 * Perhaps make Unicode strings the default, and dispense with bytestrings altogether? They're not particularly useful in text processing, are they?

Documentation on MediaWiki.org is a mess.


 * Lua – probably don't want to use this as the main title with subpages; too confusing to users
 * Scribunto – currently a redirect; probably want to use this as the main title with subpages (unique name, won't be as confusing to users)
 * Lua scripting – currently has a number of subpages
 * This page should probably be renamed to something like "Template scripting language rewrite" to get it out of the way; should be limited in scope to Wikimedia engineering project with finite duration
 * Move subpages elsewhere
 * Redirect "Lua scripting" elsewhere post-rename?
 * Add hatnote to renamed page pointing to useful pages
 * Extension:Scribunto – currently has technical subpages
 * Keep subpages where they are?

Further thoughts:


 * How do we separate Scribunto documentation from Wikimedia documentation about the use of Scribunto? Should we make a distinction?