OniGalore:Current events: Difference between revisions

From OniGalore
Jump to navigation Jump to search
(→‎BSL tutorial(s): just an FYI since I can only work on it in short sessions)
m (not "tutorials", "documentation" (tutorials are done, at any rate))
 
(51 intermediate revisions by the same user not shown)
Line 6: Line 6:
!ENOUGH FOR A JOKE OR TWO<br>THEN IT GETS BORING
!ENOUGH FOR A JOKE OR TWO<br>THEN IT GETS BORING
|}
|}
{{Hatnote|If you're not familiar with wikis, see [[OniGalore:About]]. If you're not confident about editing a wiki, see [[Help:Editing]].}}
Here are some ongoing projects, and ideas for projects, on the wiki. Whatever in this list looks interesting to you, feel free to tackle it, even if you only have a little time here and there. However, if you are leaving a project half-done until you can resume it, please note this under the item in the list. Thanks for whatever you can do to contribute.


:''If you're not familiar with wikis, see [[OniGalore:About]]. If you're not confident about editing a wiki, see [[Help:Editing]].''
{{TOClimit}}
 
These are only suggestions, although some are more obviously needed than others. Whatever in this list looks interesting to you, feel free to tackle it, even if you only have a little time here and there. However, if you are leaving a project half-done until you can resume it, please note that under the item in this list.
 
Thanks for whatever you can do to contribute.


==General wiki work==
==General wiki work==
*Look at the list of [[:Category:Flagged articles|flagged articles]] and see if there's anything you can help out with. There are a number of articles which need to be updated or finished.
* Look at [[:Category:Flagged articles]] and see if there's anything you can help out with. There are a number of articles which need to be updated or finished, including ones about characters and settings in Oni.
*Just browse [[Special:Wantedpages]], and pick an interesting topic to write about!
* Just browse [[Special:Wantedpages]] and pick an interesting topic to write about! There are many interesting parts of Oni's world which do not have a dedicated article yet.


==Improving the documentation==
==PlayStation 2 port==
===BSL tutorial(s)===
Let's expand on the [[PS2 vs PC|documentation of the PS2 version]], including how it differs from Win/Mac Oni. Besides gameplay or content differences, we might also want to check the game data for unexpected resources. First we'll probably need an [[OBD:PS2]] page for documenting the data format, since it has changed a bit from the PC version.
Despite its relative simplicity, [[BSL]] is vastly under-documented. Most of the stuff is well-known to experts, but designing a comprehensive guide that will get novice scripters started and keep them going requires didactic skills and ''lots'' of patience. Long-term goals are: a cross-referenced set of mini-tutorials that document the functions and variables in a standalone way (see, e.g., [[ai2_allpassive]]); maybe a functional breakdown of an original script (see [[BSL:Tutorial/airport1_level_logic.bsl|HERE]]); and redirects so that typing the name of the variable/function in the Go/Search box leads to just the right place.
:I am putting into effect soon a plan that will fulfill some of geyser's old goals for the BSL part of the wiki:
:*I will be making the above-mentioned mini-tutorials for the BSL "commands" (variables + functions) that center around a certain topic. I have plans to make about 30 pages, which will be listed soon. However I currently have no plans to actually write the kind of thorough tutorials that geyser would have made; instead, I am just going to port all of the var/func info to the [[Template:BSLvarinfo|var]] and [[Template:BSLfuncinfo|func]] templates that I made (using templates means that we can easily tweak the display of all commands' information later, if anyone is not enamored with the [[User:Iritscen/TestSpace|current design]]). I will also bring over any small notes on the funcs/vars that I find laying around the wiki. But there won't be a comprehensive write-up on how exactly to use each one. The main goal is just to group all commands by subject matter, so I am calling these the "grouped" pages.
:*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]]).
:*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)


::The demo is in progress, but not working yet.... --[[User:Iritscen|Iritscen]] ([[User talk:Iritscen|talk]]) 19:49, 8 December 2015 (CET)
==Angel Studios sequel==
If you have some hacking skills, please look at [[Talk:Oni 2 (Angel Studios)]] and [[OBD:Oni2AS]] to see if you can answer any outstanding questions or contribute new information.


: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)
==BSL documentation==
The revamp of the BSL docs that was originally laid out in this section is on hold because the system we were using is too rickety and hacked together. The proper approach to interlinked pages that read from the same central pool of data is the [[mw:Extension:Semantic MediaWiki|Semantic MediaWiki]] extension, so we'll focus on implementing that at some point in the future.


==Oni 2 and beyond...==
==Oni 2 and beyond...==
Some fans use the wiki to write sequels, prequels, interquels (what may have happened to Konoko in the time gaps between the original chapters, e.g., between Chapter 12 and Chapter 13) or even paraquels (e.g., what was happening on the Syndicate side during Oni?). You can then list your work [[Oni2|HERE]]. Just be aware of the [[OniGalore:Copyrights|rights issues]] attendant with posting fan fics here. Also, plagiarism is not nice, but "Oni 2" can still be influenced by anime/cyberpunk/other references. See [[:Category:Oni 2 influences|HERE]] to review the influences so far, elaborate on them some more, or point out new ones.
Some fans use the wiki to write sequels, prequels, interquels (what may have happened to Konoko in the time gaps between the original chapters, e.g., between Chapter 12 and Chapter 13) or even paraquels (e.g., what was happening on the Syndicate side during Oni?). You can then list your work [[Oni2|HERE]]. Just be aware of the [[OniGalore:Copyrights|rights issues]] surrounding fan fiction posted on the Internet. Also, plagiarism is not nice, but "Oni 2" can still be influenced by anime/cyberpunk/other references. See [[:Category:Oni 2 influences|HERE]] to review the influences so far, elaborate on them some more, or point out new ones.


[[Category:Policies and documentation]]
[[Category:Policies and documentation]]

Latest revision as of 20:08, 13 July 2023

WIKI WORK IS FUN!
Penny Arcade - EvilCorp Too.png
ENOUGH FOR A JOKE OR TWO
THEN IT GETS BORING
If you're not familiar with wikis, see OniGalore:About. If you're not confident about editing a wiki, see Help:Editing.

Here are some ongoing projects, and ideas for projects, on the wiki. Whatever in this list looks interesting to you, feel free to tackle it, even if you only have a little time here and there. However, if you are leaving a project half-done until you can resume it, please note this under the item in the list. Thanks for whatever you can do to contribute.

General wiki work

  • Look at Category:Flagged articles and see if there's anything you can help out with. There are a number of articles which need to be updated or finished, including ones about characters and settings in Oni.
  • Just browse Special:Wantedpages and pick an interesting topic to write about! There are many interesting parts of Oni's world which do not have a dedicated article yet.

PlayStation 2 port

Let's expand on the documentation of the PS2 version, including how it differs from Win/Mac Oni. Besides gameplay or content differences, we might also want to check the game data for unexpected resources. First we'll probably need an OBD:PS2 page for documenting the data format, since it has changed a bit from the PC version.

Angel Studios sequel

If you have some hacking skills, please look at Talk:Oni 2 (Angel Studios) and OBD:Oni2AS to see if you can answer any outstanding questions or contribute new information.

BSL documentation

The revamp of the BSL docs that was originally laid out in this section is on hold because the system we were using is too rickety and hacked together. The proper approach to interlinked pages that read from the same central pool of data is the Semantic MediaWiki extension, so we'll focus on implementing that at some point in the future.

Oni 2 and beyond...

Some fans use the wiki to write sequels, prequels, interquels (what may have happened to Konoko in the time gaps between the original chapters, e.g., between Chapter 12 and Chapter 13) or even paraquels (e.g., what was happening on the Syndicate side during Oni?). You can then list your work HERE. Just be aware of the rights issues surrounding fan fiction posted on the Internet. Also, plagiarism is not nice, but "Oni 2" can still be influenced by anime/cyberpunk/other references. See HERE to review the influences so far, elaborate on them some more, or point out new ones.