Skip to content

Commit

Permalink
Update linkcheck user agent and update links (#2573)
Browse files Browse the repository at this point in the history
Update linkcheck actions and python version
  • Loading branch information
sciencewhiz committed Feb 18, 2024
1 parent dff0ad7 commit 48bd0fa
Show file tree
Hide file tree
Showing 4 changed files with 15 additions and 14 deletions.
8 changes: 4 additions & 4 deletions .github/workflows/link-check.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,13 @@ env:

jobs:
check-links:
if: github.repository_owner == 'wpilibsuite'
if: github.repository_owner == 'wpilibsuite'
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-python@v4
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
with:
python-version: 3.9
python-version: 3.11
- name: Install Dependencies
run: pip install -r source/requirements.txt
- name: Check Links
Expand Down
15 changes: 8 additions & 7 deletions source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -142,17 +142,18 @@

# Linkcheck Exclusions
linkcheck_ignore = [
r".*kauailabs.com.*",
# r".*kauailabs.com.*",
r".*wpilibpi.local.*",
r".*andymark.com.*",
r".*ti.com/lit/an/spma033a/spma033a.pdf.*",
r".*java.com/en/download/help/locale.xml.*",
# r".*andymark.com.*",
# r".*ti.com/lit/an/spma033a/spma033a.pdf.*",
r".*java.com.*",
r".*playingwithfusion.com/contactus.php.*",
r".*github.com/wpilibsuite/BetaTest.*",
r".*vexrobotics.com/docs/.*",
# r".*vexrobotics.com/docs/.*",
r".*forums.firstinspires.org.*",
r".*digikey.com.*",
r".*chiefdelphi.com.*",
r".*raspberrypi.com.*",
r".*stackoverflow.com.*",
]

# Sets linkcheck timeout in seconds
Expand All @@ -161,7 +162,7 @@
linkcheck_workers = 1

# Specify a standard user agent, as Sphinx default is blocked on some sites
user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36"
user_agent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36"

# Autosection labels prefix document path and filename
autosectionlabel_prefix_document = True
Expand Down
2 changes: 1 addition & 1 deletion source/docs/yearly-overview/known-issues.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Radio Second Port Sometimes Fails to Communicate

**Issue:** There is a rare occurrence in the OM5P Radios that causes the second Ethernet port (the one farthest from the power plug) to not communicate.

**Workaround:** Generally, power cycling the radio will restablish communication with the second port. Alternately, utilize a network switch such as the tp-link switch available from `FIRST Choice <https://firstchoicebyandymark.com/fc-cn-9024>`__ or the `brainboxes SW-005 <https://www.brainboxes.com/product/industrial-ethernet-switches/fast-ethernet/sw-005>`__ and plug all ethernet devices into the network switch and then plug the switch into the radio's first Ethernet port. This also allows easier tethering while at competition.
**Workaround:** Generally, power cycling the radio will restablish communication with the second port. Alternately, utilize a network switch such as the tp-link switch formerly available from `FIRST Choice <https://www.amazon.com/gp/product/B000FNFSPY>`__ or the `brainboxes SW-005 <https://www.brainboxes.com/product/industrial-ethernet-switches/fast-ethernet/sw-005>`__ and plug all ethernet devices into the network switch and then plug the switch into the radio's first Ethernet port. This also allows easier tethering while at competition.

Onboard I2C Causing System Lockups
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Expand Down
4 changes: 2 additions & 2 deletions source/docs/zero-to-robot/step-3/radio-programming.rst
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ If you need to load the FRC firmware (or reset the radio), you can do so using t

.. warning:: If you see an error about NPF name, try disabling all adapters other than the one being used to program the radio. If only one adapter is found, the tool should attempt to use that one. See the steps in :ref:`Disabling Network Adapters <docs/networking/networking-introduction/roborio-network-troubleshooting:Disabling Network Adapters>` for more info.

Teams may also see this error with Operating Systems configured for languages other than US English. If you experience issues loading firmware or programming on a foreign language OS, try using an English OS, such as on the KOP provided PC or setting the Locale setting to "en_us" as described on `this page <https://www.java.com/en/download/help/locale.xml>`_.
Teams may also see this error with Operating Systems configured for languages other than US English. If you experience issues loading firmware or programming on a foreign language OS, try using an English OS, such as on the KOP provided PC or setting the Locale setting to "en_us" as described on `this page <https://www.java.com/en/download/help/locale.html>`_.

Select Radio and Operating Mode
-------------------------------
Expand Down Expand Up @@ -210,7 +210,7 @@ Troubleshooting
- Make sure your firewall is turned off.
- Plug directly from your computer into the wireless bridge and make sure no other devices are connected to your computer via ethernet.
- Ensure the ethernet is plugged into the port closest to the power jack on the wireless bridge.
- If using an Operating System configured for languages other than US English, try using an English OS, such as on the KOP provided PC or setting the Locale setting to "en_us" as described on `this page <https://www.java.com/en/download/help/locale.xml>`_.
- If using an Operating System configured for languages other than US English, try using an English OS, such as on the KOP provided PC or setting the Locale setting to "en_us" as described on `this page <https://www.java.com/en/download/help/locale.html>`_.
- Due to Unicode incompatibles, non-US Teams may face a configuration failure because of incorrect network interface reading. In that case, change the network adapter name to another name in English and retry.
- Some users have reported success after installing `npcap 1.60 <https://npcap.com/>`__. If this doesn't resolve the issue, it's recommended to uninstall npcap and the radio tool and then reinstall the radio tool in order to get back to a known configuration.
- If all else fails, try a different computer.

0 comments on commit 48bd0fa

Please sign in to comment.