diff --git a/Doc/sphinx/bugreport.rst b/Doc/sphinx/bugreport.rst index 3bed13e..de873e5 100644 --- a/Doc/sphinx/bugreport.rst +++ b/Doc/sphinx/bugreport.rst @@ -10,27 +10,41 @@ click its link and add any information you can into the comments. If your bug do exist, follow these steps: 1. Upon opening that page, you should see a "Report Issue" link. Click this. + 2. Now, you should select the project to report to. Use the following criteria: + - If the problem is with the GUI, choose "Simba". + - If the problem seems to be in the library, choose "MML". + - If the problem is not in one of the above or you know it is an SRL function causing the problem, choose "SRL". + If you can not decide, choose "Simba". The developers can move the ticket as needed. + 3. Now, choose the Category that the bug is in. This should be self-explanatory; choose a topic related to what you were doing when the bug occured. Choose general if you are unsure. Developers can, again, change the ticket if required. + 4. Select the reproducability. If this is a request for a feature, choose "N/A". + 5. Severity should be ranked according to how much the bug affects the program. Crashes will be dealt with first, then blocks, etc. This step goes along with priority, which should be chosen along with the severity. + 6. Version, at this time, is not needed for Simba and MML issues. If the issue occurs with an older script, choose "SRL 4 Compatibility". + 7. Now write the summary of the bug. Choose something better than "Does not Work". If, for example, you were experiencing a crash of the program when trying to use the OCR to scan the character "~" on the 30th of February while you were woodcutting willows with an iron axe, a suitable Summary might be "Crash While Using OCR on Specific Char". + 8. Using the same example for above, a Description should explain the problem while being concise. This field is not the field for technical details, simply describe the problem. + 9. Include any technical details such as what exactly you did, etc. Use pictures if possible. + 10. Finally, hit submit. It should return successful. + diff --git a/Doc/sphinx/index.rst b/Doc/sphinx/index.rst index 0122669..1ed9c1c 100644 --- a/Doc/sphinx/index.rst +++ b/Doc/sphinx/index.rst @@ -6,6 +6,9 @@ Welcome to the Simba documentation! =================================== +.. note:: + The documentation is still WIP (Work In Progress) + Welcome to the Documentation for the Simba project. Contents: @@ -21,8 +24,9 @@ Contents: troubleshooting.rst bugreport.rst tutorial.rst - reference.rst - scriptreference.rst + referencescript.rst + referencesimba.rst + referencemml.rst docdoc.rst todo.rst pymml.rst diff --git a/Doc/sphinx/mmlref/bitmap.rst b/Doc/sphinx/mmlref/bitmap.rst new file mode 100644 index 0000000..43fbb9a --- /dev/null +++ b/Doc/sphinx/mmlref/bitmap.rst @@ -0,0 +1,4 @@ +TMufasaBitmap Class +=================== + + diff --git a/Doc/sphinx/mmlref/client.rst b/Doc/sphinx/mmlref/client.rst new file mode 100644 index 0000000..aab2500 --- /dev/null +++ b/Doc/sphinx/mmlref/client.rst @@ -0,0 +1,2 @@ +TClient Class +============= diff --git a/Doc/sphinx/mmlref/finder.rst b/Doc/sphinx/mmlref/finder.rst new file mode 100644 index 0000000..3972bfa --- /dev/null +++ b/Doc/sphinx/mmlref/finder.rst @@ -0,0 +1,4 @@ +TMFinder Class +============== + + diff --git a/Doc/sphinx/mmlref/iomanager.rst b/Doc/sphinx/mmlref/iomanager.rst new file mode 100644 index 0000000..df45429 --- /dev/null +++ b/Doc/sphinx/mmlref/iomanager.rst @@ -0,0 +1,9 @@ +TWindow Class +============= + +.. toctree:: + :maxdepth: 2 + + linux.rst + windows.rst + diff --git a/Doc/sphinx/mmlref/ocr.rst b/Doc/sphinx/mmlref/ocr.rst new file mode 100644 index 0000000..b7e697a --- /dev/null +++ b/Doc/sphinx/mmlref/ocr.rst @@ -0,0 +1,4 @@ +TMOCR Class +=========== + + diff --git a/Doc/sphinx/mmlref/os_linux.rst b/Doc/sphinx/mmlref/os_linux.rst new file mode 100644 index 0000000..491f4d4 --- /dev/null +++ b/Doc/sphinx/mmlref/os_linux.rst @@ -0,0 +1,4 @@ +Linux Specific Code +=================== + + diff --git a/Doc/sphinx/mmlref/os_windows.rst b/Doc/sphinx/mmlref/os_windows.rst new file mode 100644 index 0000000..1b64aac --- /dev/null +++ b/Doc/sphinx/mmlref/os_windows.rst @@ -0,0 +1,4 @@ +Windows Specific Code +===================== + + diff --git a/Doc/sphinx/referencemml.rst b/Doc/sphinx/referencemml.rst new file mode 100644 index 0000000..dc29c1b --- /dev/null +++ b/Doc/sphinx/referencemml.rst @@ -0,0 +1,10 @@ +MML Reference +============= + +The Mufasa Macro Library is the core library of Simba. + +.. toctree:: + :maxdepth: 2 + + mmlref/client.rst + mmlref/iomanager.rst diff --git a/Doc/sphinx/scriptreference.rst b/Doc/sphinx/referencescript.rst similarity index 100% rename from Doc/sphinx/scriptreference.rst rename to Doc/sphinx/referencescript.rst diff --git a/Doc/sphinx/reference.rst b/Doc/sphinx/referencesimba.rst similarity index 100% rename from Doc/sphinx/reference.rst rename to Doc/sphinx/referencesimba.rst diff --git a/Doc/sphinx/whatis.rst b/Doc/sphinx/whatis.rst index 03ec243..5cd1cad 100644 --- a/Doc/sphinx/whatis.rst +++ b/Doc/sphinx/whatis.rst @@ -20,6 +20,8 @@ Simba can: * Connect to the internet to read websites and post data to them. * Read text on the screen and turn it into actual text. (Optical Character Recognition) + * Run pascal programs for you. If you're a bit creative you can have a lot + of fun stuff with Simba, you can even make a game in it. and much, much more. Start now by :ref:`installingsimba`.