Cool resource for mechanical folks, but the software resources could use some work. First, a general comment.
You might want to run ghostscript on the pdf to slim it down. I was able to reduce it from 236MB to 17MB with no discernible loss in image quality (the images are way higher dpi than they need to be). You generally only want highest res when sending it to a publishing company.
gs -sDEVICE=pdfwrite \
-dCompatibilityLevel=1.7 \
-dPDFSETTINGS=/ebook \
-dEmbedAllFonts=true \
-dSubsetFonts=true \
-dFastWebView=true \
-dPrinted=false \
-dNOPAUSE \
-dQUIET \
-dBATCH \
-sOutputFile=nasarap-rdc-v101-compressed.pdf \
nasarap-rdc-v101.pdf
Thereās other PDFSETTINGS options for various use cases like āprinterā or āprepressā.
Thereās a lot of outdated links in the software resources (especially for C++). The software section links to āFRC Programming Done Rightā, but that project has been dead for a while. There were multiple issues filed on GitHub questioning its factual accuracy, and it was eventually taken down once docs.wpilib.org gained critical mass. Iād remove the link.
The software resources links for C++ could use some cleanup as well. āOfficial C++ Tutorialā is not actually official, and itās severely outdated (it was written before 2011 and C++11). In fact, a lot of the things that tutorial encourages like pointers and manual memory allocation are frowned upon in many scenarios in modern C++ by actual official sources (C++ Core Guidelines). Iād suggest the links on Introduction ā FIRST Robotics Competition documentation instead for various C++ books and tutorials.
ā971 C Programmingā was last updated in 2012 and references WPILib materials that are no longer relevant, let alone supported. Based on the content, itās only really intended for 971 as some of the stuff it mentions isnāt what an average FRC team should be doing. Iām fairly certain 971 doesnāt even use that page themselves anymore given how outdated the information is.
āFRC C Programmingā looks vaguely like the PDF output of ScreenSteps, which was superseded by docs.wpilib.org for the 2020 season, so it should be removed. The PDF in question was last updated in 2018, and the WPILib setup instructions all mention Eclipse, which was retired for the 2019 season. Several of the examples donāt even compile because WPILib has either deprecated or removed features and replaced them with better things.
Maybe this would benefit from having the source in GitHub so people can make PRs to fix up some stuff? I can say from experience that having a CI pipeline for book publishing is super nice. 