SR2024 - Update Section - Programming

Author: 8BitJosh

programming/index.md

@@ -3,37 +3,36 @@ layout: page
 title: Programming
 ---
 
-Programming Your Robot
-======================
+# Programming Your Robot
 
-<!-- Robots that are made using the SR kit are programmed with [Python](/docs/programming/python/) which is made possible with a custom-built Python library, `sr.robot3`; see [here](/docs/programming/robot_api/) for more details. The pages under this section should contain all of the information you need to know to successfully code for your robot.
+Robots build using the SR kit are programmed with [Python 3.11](https://www.python.org) which is made possible with a custom-built Python library, `sr.robot3`.
+This library deals with talking to the boards and doing all the complicated bits so you can focus on the fun bits.
 
-* In order to develop the code for your robot, we recommend that you use a code
-  editor. For more information about this, including some suggestions for
-  suitable editors, see the [Code Editors](/docs/programming/editors/) section.
+The [Robot API]({{ site.baseurl }}/programming/robot_api/) page has the details about this library.
+The other pages in this section contain all of the information you need to know to successfully code for your robot.
 
-* Under the [Python](/docs/programming/python/) section, some of the more intricate features of Python are explained in sufficient detail to program a robot. Links to tutorials are also provided to introduce a new programmer to Python.
 
-* Under the [sr](/docs/programming/sr/) section is an API reference for the Student Robotics module, used to interface with the hardware. -->
+## Learning python
 
-
-<!--
-TODO - below is from python page
-
-Student Robotics robots are all programmed in [Python 3.10](https://www.python.org);
-to program a robot, it is important that you have a basic understanding of Python.
+Your robot is programmed in [Python](https://www.python.org), so to make your robot do things you will need at least a basic understanding of Python.
 
 There are a number of tutorials out there which might help you to learn to program in Python:
 
 * [Our tutorial](/docs/tutorials/python), called _Python: A whirlwind tour_.
-    This was written especially for Student Robotics competitors,
-    and explains the basics while trying not to overwhelm you.
+    This was written especially for Student Robotics competitors, and explains the basics while trying not to overwhelm you.
+
+* [The Official Tutorial](https://docs.python.org/3.10/tutorial/) -- The tutorial provided by the people who make Python.
+    Most of the useful stuff starts at chapter 3, but you should at least skim the stuff before it; there is a lot there and it may be a little overwhelming.
+
+* A number of beginners tutorials are linked to from the [python wiki](https://wiki.python.org/moin/BeginnersGuide/NonProgrammers).
+    One of these that we would suggest is the [Wikibooks Tutorial](https://en.wikibooks.org/wiki/Non-Programmer%27s_Tutorial_for_Python_3).
+
+* [The Official Python Docs](https://docs.python.org/3.11/) contains every piece of information about the core language that you would need.
+    The format isn't that digestible, use it as a reference and use the search to find a specific section that you need.
 
-* [The Official Tutorial](https://docs.python.org/3.10/tutorial/) -- the good stuff starts at chapter 3,
-    but you should at least skim the stuff before it;
-    there is a lot there and it may be a little overwhelming.
 
-* A number of tutorials for beginners are linked to from [here](https://wiki.python.org/moin/BeginnersGuide/NonProgrammers).
-    [Wikibooks Tutorial](https://en.wikibooks.org/wiki/Non-Programmer%27s_Tutorial_for_Python_3) seems like a good one.
+## Writing code
 
-* [The Official Docs](https://docs.python.org/3.10/), for the version of python on the [Brain Board](/docs/kit/brain_board). -->
+In order to develop the code for your robot, we recommend that you use a code editor.
+A good code editor can provide you with features such as auto completion and syntax highlighting which will help you more easily write code.
+For suggestions of suitable editors, and how to set them up see the [Code Editors]({{ site.baseurl }}/tutorials/editors/) section.