Merge remote-tracking branch 'upstream/main' into coordinates

Author: agasser

source/docs/software/advanced-controls/system-identification/creating-routine.rst

@@ -65,11 +65,11 @@ To be able to run the tests, SysIdRoutine exposes test "factories", or functions
   .. code-block:: java
 
     public Command sysIdQuasistatic(SysIdRoutine.Direction direction) {
-      return m_sysIdRoutine.quasistatic(direction);
+      return routine.quasistatic(direction);
     }
 
     public Command sysIdDynamic(SysIdRoutine.Direction direction) {
-      return m_sysIdRoutine.dynamic(direction);
+      return routine.dynamic(direction);
     }
 
-Either bind the factory methods to either controller buttons or an create an autonomous routine with them. It is recommended to bind them to buttons that the user must hold down for the duration of the test so that the user can stop the routine quickly if it exceeds safe limits.
+Either bind the factory methods to either controller buttons or create an autonomous routine with them. It is recommended to bind them to buttons that the user must hold down for the duration of the test so that the user can stop the routine quickly if it exceeds safe limits.

source/docs/software/networktables/tables-and-topics.rst

@@ -99,4 +99,4 @@ Having a Topic object or handle does not mean the topic exists or is of the corr
 
             # get a type-specific topic from a generic Topic
             genericTopic = inst.getTopic("/datatable/X")
-            dblTopic = new DoubleTopic(genericTopic)
+            dblTopic = ntcore.DoubleTopic(genericTopic)

source/docs/software/roborio-info/roborio-ssh.rst

@@ -11,7 +11,7 @@ roboRIO User Accounts
 ---------------------
 The roboRIO image contains a number of user accounts, but there are two of primary interest for FRC.
 
-Admin
+admin
 ^^^^^
 The "admin" account has root access to the system and can be used to manipulate OS files or settings. Teams should take caution when using this account as it allows for the modification of settings and files that may corrupt the operating system of the roboRIO. The credentials for this account are:
 
@@ -21,11 +21,11 @@ The "admin" account has root access to the system and can be used to manipulate
 
 .. note:: The password is intentionally blank.
 
-Lvuser
+lvuser
 ^^^^^^
 The "lvuser" account is the account used to run user code for all three languages. The credentials for this account should not be changed. Teams may wish to use this account (via ssh or sftp) when working with the roboRIO to ensure that any files or settings changes are being made on the same account as their code will run under.
 
-.. danger:: Changing the default ssh passwords for either "lvuser" or "admin" will prevent C++ and Java teams from uploading code.
+.. danger:: Changing the default ssh passwords for either "lvuser" or "admin" will prevent C++, Java, and Python teams from uploading code.
 
 SSH
 ---

source/docs/yearly-overview/known-issues.rst

@@ -31,6 +31,21 @@ On Linux/macOS execute the following:
 
 After running those, you’ll need to refresh Java intellisense in VS Code for it to pick up the new files. You can do so by running the ``Clean Java Language Server Workspace`` command in VS Code.
 
+Driver Station Reports Less Free RAM then is Available
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+**Issue:** The Driver Station diagnostic screen reports free RAM that is misleadingly low. This is due to Linux's use of memory caches. Linux will cache data in memory, but then relinquish when the robot programs requests more memory. The Driver Station only reports memory that isn't used by caches.
+
+**Workaround:** The true memory available to the robot program is available in the file ``/proc/meminfo``. :doc:`Use ssh to connect to the robot </docs/software/roborio-info/roborio-ssh>`, and run ``cat /proc/meminfo``.
+
+.. code-block:: text
+
+   MemTotal:         250152 kB
+   MemFree:           46484 kB
+   MemAvailable:     126956 kB
+
+The proper value to look is as MemAvailable, rather then MemFree (which is what the driver station is reporting).
+
 Driver Station Reporting No Code
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^