colcon build not working about ros2_documentation HOT 2 OPEN

1. Tutorial should state that it would be a good practice to call it with parameter --parallel-workers N

This is a tradeoff. First of all, there is no value of N we could put in there that would be correct. It would be different for everyone. Also, these are the beginner tutorials, so we want to make things as simple as possible. So I don't particularly think we should do this.

2. colcon fails to build with newer setuptools where it is deprecated to call setup.py directly

This should not have caused a failure. It does cause warnings as you've seen, but they should not be fatal. Can you please paste in the logs of the failing build?

from ros2_documentation.

This is a tradeoff. First of all, there is no value of N we could put in there that would be correct. It would be different for everyone. Also, these are the beginner tutorials, so we want to make things as simple as possible. So I don't particularly think we should do this.

I totally agree with that. Setting up a number of jobs is a more advanced topic. Yet still, in my case my laptop lagged so much that I needed to forcely, with a power button, restart a computer. For a beginners tutorial, that can be quite discouraging. Further decision on that is on your judgment.

This should not have caused a failure. It does cause warnings as you've seen, but they should not be fatal. Can you please paste in the logs of the failing build?

Starting >>> examples_rclpy_executors
--- stderr: examples_rclpy_executors
/usr/lib/python3/dist-packages/setuptools/command/easy_install.py:158: EasyInstallDeprecationWarning: easy_install command is deprecated. Use build and pip and other standards-based tools.
warnings.warn(
/usr/lib/python3/dist-packages/setuptools/command/install.py:34: SetuptoolsDeprecationWarning: setup.py install is deprecated. Use build and pip and other standards-based tools.
warnings.warn(

Finished <<< examples_rclpy_executors [7.63s]
...
Summary: 22 packages finished [1min 53s]
10 packages had stderr output: examples_rclpy_executors examples_rclpy_guard_conditions examples_rclpy_minimal_action_client examples_rclpy_minimal_action_server examples_rclpy_minimal_client examples_rclpy_minimal_publisher examples_rclpy_minimal_service examples_rclpy_minimal_subscriber examples_rclpy_pointcloud_publisher launch_testing_examples

I agree with you it is a warning. Althoughts maybe a subsection describing a behaviour of that kind would be helpful. Again, it is up to your judgement.

from ros2_documentation.