Revamp a couple of tf2 tutorials to flow better.

[clalancette]

That is, make sure we put in all the steps that need to be
done, and more logically organize the sections. This should
make them easier to follow.

Signed-off-by: Chris Lalancette clalancette@openrobotics.org

[kurshakuz]

.

[kurshakuz]

I agree that the proposed additions make the flow much better. My only concern now is that headings on the same level have different number prefixes.

What I suggest to do is to firstly change the Contents depth to 2 as it is in other tf2 tutorials. This will hide low-level sections from a Contents tree.

Secondly, we will need to either change the number prefixes to the previous format or to change the heading type of the updated sections.

[kurshakuz]

Let's either change the heading type or the prefix number here and in similar places

[clalancette]

Thanks for the review, it is appreciated.

What I suggest to do is to firstly change the Contents depth to 2 as it is in other tf2 tutorials. This will hide low-level sections from a Contents tree.

For both of the "Adding a Frame" tutorials, I think it makes sense to have a depth of 3 for the table of contents. That's because there are 2 separate "tasks" in these tutorials, and each task has a number of sub-tasks. So I left it at 3 for now.

Secondly, we will need to either change the number prefixes to the previous format or to change the heading type of the updated sections.

You are absolutely correct about this; I didn't go through and renumber properly. I've now done that in the latest commit, so the whole thing should make a lot more sense. Please take another look when you get a chance. Thanks!

[kurshakuz]

LGTM!

[clalancette]

Thanks! Going ahead and merging and backporting this one.