wpilibsuite / frc-docs

Official FRC Documentation powered by Read the Docs
https://docs.wpilib.org
Other
144 stars 257 forks source link

Shuffleboard commands examples should use Shuffleboard methods. #2003

Open blu28 opened 1 year ago

blu28 commented 1 year ago

The section of the docs on Shuffleboard shows an example of putting a command on the Shuffleboard using the SmartDashboard method SmartDashboard.putData. It should show how to put commands in the Shuffleboard using Shuffleboard methods. Also, there is an image showing a group of commands and the image is referenced in the text as an example of grouping commands on the Shuffleboard, but there is no example code to go with it. Since the only examples use the SmartDashboard methods, it is not at all obvious how you make this group command.

Daltz333 commented 1 year ago

While this is a perfectly valid issue, Shuffleboard is more-or-less in maintenance mode. So unless an external contributor steps up, I don't think this will get fixed. I'll leave this open for anybody to tackle.

blu28 commented 1 year ago

If Shuffleboard is in maintenance mode, what should teams be concentrating on using for the future?

Daltz333 commented 1 year ago

A successor is currently not in the progress. The issue is that there is no developer momentum. WPILib is an open source project, and as such suffers from things a paid organization have (like bandwidth to focus on issues that a developer would typically not pick up otherwise).

Tangentially. Dashboards are a lot of work, so much work that they tend to be associated with a graduation project of some sort (the case for all of our non-IMGUI dashboards). This ends up creating a situation where the core developer graduates/moves on. It's unfortunate, but just kind of the way it works.

Glass is an imgui dashboard that's being updated/maintained by long-term dev @PeterJohnson, but he tends to have a lot on his plate as well, as the primary maintainer for the allwpilib codebase and the primary developer for NT. It's a ways out from being a Shuffleboard replacement, but we'll see where the future takes us.

We'll still fix critical bugs, but I don't think anyone is being proactive and actively adding new features to Shuffleboard.

PeterJohnson commented 1 year ago

There’s been some increased commit traffic in the last couple weeks… we will see if it continues.