Merge pull request #19 from RISC-OS-Community/develop

pzaino · web-flow · commit 5f0f9190ad3b · 2022-11-27T00:43:32.000Z
Ideas list update after fireside chat meeting, publication of first scheduled meeting
diff --git a/README.md b/README.md
@@ -14,6 +14,7 @@ This repository is organised in multiple "levels":
 * [Ideas](doc/RISCOSCodingMeetingsIdeas.md) for meetings (we provide Zoom based monthly meetings with presentations on everything coding on RISC OS)
 * [Forums](doc/RISCOSCodingForums.md) where to ask questions related to code on RISC OS
 * [RISC OS Coding meetings](doc/RISCOSCodingMeetings.md) material
+* [Meetings Schedule](doc/RISCOSCodingMeetingsSchedule.md)
 * Useful [Code Snippets](src), which are organised by programming language and features.
 
 ## Contributing
diff --git a/doc/RISCOSCodingMeetings.md b/doc/RISCOSCodingMeetings.md
@@ -22,6 +22,8 @@ Meetings are recorded.
 
 Recordings will be split too, so people willing to watch on YouTube will have an easy life to find what they need.
 
+Video recording will be split where possible in small sections easier to follow and to be indexed on the Internet or subdivided in chapters where it's better to keep everything in one place.
+
 Meetings are informal. So, no need to prepare ultra-professional presentations, however using slides and diagrams to explain concepts is welcome and we recommend to ensure always to show code in a "show and tell" form.
 
 Presentations can be pre-recorded to help the presenter or to make it easy to show processes that may take long time, however, in these cases, we'd recommend the presenter to also be in the live meeting for the Q&A session at the end of their presentation.
diff --git a/doc/RISCOSCodingMeetingsIdeas.md b/doc/RISCOSCodingMeetingsIdeas.md
@@ -14,30 +14,98 @@ In the advanced part more advanced presentation and coding discussions take plac
 
 ### Beginners
 
+* Getting the code!
+  * What is Git and why use Git
+  * How to use git on Windows to get RISC OS code (Robert Sprowson)
+  * How to use git on Linux to build RISC OS code on RISC OS via OmniClient/LanMan98
+  * How to use git on macOS to build RISC OS code (Charles Gerph)
+  * How to use git on GCCSDK to cross compiler for RISC OS (Steve Fryatt)
+  * How to use !Simplegit on RISC OS (Cameron Cawley)
+
+* How to use StrongEd for code editing
+
+* How to use VS Code to code on RISC OS (or other modern IDEs)
+  * Using VS Code for GCCSDK and BBC BASIC (Steve Fryatt)
+
 * Mini course on programming in BBC BASIC on RISC OS
+  * Let's start (Christopher Dewhurst)
+  * Calling SWIs (Christopher Dewhurst)
+  * How to use the GPIO on Raspberry Pi (TBD)
+  * How to use the Toolbox (TBD)
+  * How to use Fonts (both in full screen and Windows)
+  * Graphics in a Window
+
 * Mini course on programming in C on RISC OS
-* Mini course on moving from BBC BASIC to C on RISC OS?
+  * How to use GCC Compiler (TBD)
+    * How to install GCC on RISC OS
+    * How to compile Hello World
+    * Static Linking
+    * Dynamic Linking
+  * How to use DDE Compiler (TBD)
+    * How to install the compiler
+    * How to compile Hello World
+    * Static Linking
+  * Make Files
+    * What are they
+    * How to write them for RISC OS (TBD)
+  * Wimp Programming (Steve Fryatt)
+  * Using the ToolBox (TBD)
+  * Graphics in a Window
+  * Mini course on improving C syntax and form
+
+* Cross-compiling code for RISC OS
+  * How to use CMake for Cross Compiling (Cameron)
+
 * Mini course on programming in Lua on RISC OS
+  * Introduction to RiscLua (TBD)
+  * Wimp Programming (TBD)
+  * How to use the Toolbox (TBD)
+  * How to use Fonts (both in full screen and Windows)
+  * Graphics in a Window
+
 * Mini course on programming in Python on RISC OS
+  * Let's start (Chris Johns)
+  * Calling SWIs (Chris Johns)
+  * How to use the GPIO on Raspberry Pi (TBD)
+  * How to use the Toolbox (TBD)
+  * Graphics in a Window
+
 * Mini course on designing multi-tasking applications on RISC OS
-* Mini course on improving C syntax and form
+  * Cooperative Multitasking on RISC OS (TBD)
+  * Code Slicing and how to write algorithms that are Cooperative Multitasking friendly (TBD)
+  * Handling messages
+  * The ToolBox (see each specific programming language)
+
 * Mini course on developing 2D games on RISC OS
-* Mini course on programming in C++ on RISC OS?
+  * Introduction to SDL on RISC OS and cross compiling (Cameron Cawley)
+
+* Mini course on programming in C++ on RISC OS? (TBD)
+
+* How to test and debug software on RISC OS
+  * General code testing on RISC OS (Gerph)
+  * Introduction to Report (Chris Johns)
+  * How to use MemoryI and all the other debug modules (TBD)
+  * How to use GDBServer for remote debugging (TBD)
+  * Debugging code on RISC OS Pyromanic (Gerph)
+  * Writing Unit Test using mUnit lib (Paolo)
+  * Writing Unit Tests using Greatest libs (Paolo)
+  * Debugging RISC OS using JTAG (Sprow?)
 
 ### Advanced
 
-* Writing TaskModules 
-* Writing Device Drivers for RISC OS
-* Writing DLLs for GCC
-* Writing Demos for RISC OS
-* Mini course on coding optimization for BBC BASIC programmers
-* Mini course on coding optimization for C programmers
-* Debugging techniques for BBC BASIC programmers
-* Debugging techniques for C developers
-* Debugging techniques for C++ developers
-* Using Jeffrey's SMP library
+* Writing TaskModules (TBD)
+* Writing Device Drivers for RISC OS (TBD)
+* Writing DLLs for GCC (TBD)
+* Writing Demos for RISC OS (TBD)
+* Mini course on coding optimization for BBC BASIC programmers (TBD)
+* Mini course on coding optimization for C programmers (TBD)
+* Advanced Debugging techniques for BBC BASIC programmers (TBD)
+* Advanced Debugging techniques for C developers (TBD)
+* Advanced Debugging techniques for C++ developers
+* How to use Jeffrey's SMP library
 * Building RISC OS Operating System
-* Introduction to Simon's C kernel?
+  * How to create RISC OS ROM (Robert Sprowson)
+* Introduction to Simon's Wilson C kernel?
 * Using ARM NEON instructions in BBC BASIC
 * Using ARM NEON instructions in C
 * Using Dynamic Linking in Lua
@@ -48,3 +116,9 @@ In the advanced part more advanced presentation and coding discussions take plac
 * Porting software using the GCCSDK autobuilder
 * PackMan, packaging and packaging infrastructure
 * GCC shared libraries and how they work
+
+## Show and Tell
+
+* How people "do things" on RISC OS
+  * Workflows, tools used etc.
+
diff --git a/doc/RISCOSCodingMeetingsSchedule.md b/doc/RISCOSCodingMeetingsSchedule.md
@@ -0,0 +1,22 @@
+# Scheduled Meetings
+
+## meeting 1 - 21st of January 2023
+
+### Beginner section - Getting the code
+
+* Why Git?
+* Practical sessions:
+  * Using git on MS Windows (Rob Sprowson)
+  * Using git with GCCSDK for cross compilation (Steve Fryatt)
+  * Using git on macOS for RISC OS coding and Pyromanic (Gerph)
+  * Using git on Linux for RISC OS coding with !OmniClient and Nettle (Paolo)
+  * Using !SimpleGit on RISC OS (Cameron Cawley)
+* Questions session
+
+1 hour beginners section
+
+### Advanced Section
+
+* Show and Tell, share your projects/problems and questions
+
+No official time limit
diff --git a/doc/SideRequests.md b/doc/SideRequests.md
@@ -0,0 +1,7 @@
+# Side requests that need some extra thought to be delivered
+
+## Req: Would it be possible to have a Unix-like "man" (manual) documentation tool for RISC OS?
+
+* Points to understand
+  * Sync up with Gerph for his documentation project
+  * Try to figure out a way to build a "man-like" documentation
