19,584
edits
OniGalore:Current events: Difference between revisions
→BSL tutorial(s): oh yeah, about Manual and Introduction...
(→BSL tutorial(s): detailing my plan, in case there are any comments) |
(→BSL tutorial(s): oh yeah, about Manual and Introduction...) |
||
| Line 24: | Line 24: | ||
:*Pages will be created for every function and variable. Viewing a page for a single command should give you the standard template display of the command's information, but there should also be a redirect link that goes to the grouped page, so you can view the command's documentation in context. | :*Pages will be created for every function and variable. Viewing a page for a single command should give you the standard template display of the command's information, but there should also be a redirect link that goes to the grouped page, so you can view the command's documentation in context. | ||
:*A new page (originally to be called "BSL:Reference", but probably now going to be called something else; maybe "BSL:List of built-in commands"?) will list all functions and variables together. It will be sortable by name, group (subject matter), type (func or var), and platform availability (Win/Mac), but will not contain any other info on the commands. It's just intended as a quick reference. You will be able to click the name of any command to go to the grouped page that discusses it in the context of related commands. This table will hopefully be built automatically from the information entered elsewhere (sample [[User:Iritscen/TestSpace2|here]]). | :*A new page (originally to be called "BSL:Reference", but probably now going to be called something else; maybe "BSL:List of built-in commands"?) will list all functions and variables together. It will be sortable by name, group (subject matter), type (func or var), and platform availability (Win/Mac), but will not contain any other info on the commands. It's just intended as a quick reference. You will be able to click the name of any command to go to the grouped page that discusses it in the context of related commands. This table will hopefully be built automatically from the information entered elsewhere (sample [[User:Iritscen/TestSpace2|here]]). | ||
:*When this is done, BSL:Functions and BSL:Variables will be | :*When this is done, BSL:Functions and BSL:Variables will be replaced by messages that redirect the reader to the instructions for using functions/variables on [[BSL:Manual]], or else the command list on the "Reference" page, whichever they are looking for. No longer will we have to browse two pages at once while trying to find a command we're thinking of but can't remember if it is a variable or function. | ||
:If anyone has any questions or concerns, either now or as I perform the work and things start to take shape, I guess we can just talk about it here (I will clear the talk when the project is done). If it's not clear what I am proposing, I will have a fuller "demo" available in the next few days that shows how the system is supposed to work. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 23:06, 7 December 2015 (CET) | :If anyone has any questions or concerns, either now or as I perform the work and things start to take shape, I guess we can just talk about it here (I will clear the talk when the project is done). If it's not clear what I am proposing, I will have a fuller "demo" available in the next few days that shows how the system is supposed to work. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 23:06, 7 December 2015 (CET) | ||
:Oh, I also just created [[BSL:Manual]] by merging together all of the pages about BSL (and filling in the blanks that had never been documented). I think it's easier to read a single long, interconnected page on this subject than to click around the wiki, reading about disconnected subjects like "Operators" and "Keywords". I am not rapidly editing the Manual anymore, so it's safe for others to edit it if they want to fix something. I did a lot of research and testing while writing it, but there are still probably some mistakes. One of the topics I am less experienced with is the various uses of "fork". So it would be good if experienced scripters could read over the Manual page, and also its "[[wikipedia:CliffsNotes|Cliff's Notes]]" version, [[BSL:Introduction]]. --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 23:20, 7 December 2015 (CET) | |||
==Oni 2 and beyond...== | ==Oni 2 and beyond...== | ||