You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Most developers want a one-time investment experience when it comes to CodeTour. Attaching CodeTour tags inside the code so that the steps are attached to tags instead of line numbers would help make sure that tours don't become outdated too quickly.
As a tour viewer:
I click the "Play" button and the tour plays in the codebase.
I see that there are CodeTour tags that look like "//CT 2.2 - Starting the tree" where the first part denotes the step and the second part denotes the title of the step.
If I am not viewing a CodeTour, I am able to hide the CodeTour tags in the codebase.
As a tour author:
I create a CodeTour step using the existing flow, and once I am done, I click "Save Step" and a CodeTour tag gets inserted into code.
I have the option to remove all CodeTour tags from my codebase or add all CodeTour tags to my codebase via an icon in the sidebar.
If I want to remove all CodeTour tags from the codebase, the steps will be attached to lines of code, not tags.
The text was updated successfully, but these errors were encountered:
gracegtaylor
changed the title
Adding CodeTour tags inside code so that steps are attached to tags instead of line numbers
Add CodeTour tags inside code for tour resiliency
Feb 19, 2021
Since we'd be adding actual comments to the code base, we unfortunately wouldn't be able to hide these tags from the viewer. They'd represent an actual line of code, and VS Code doesn't support the notion of hiding lines from the editor. Do you think that will change the appeal of this solution for some folks? Since the tours wouldn't get taken often, but the markers would always be in the codebase?
Most developers want a one-time investment experience when it comes to CodeTour. Attaching CodeTour tags inside the code so that the steps are attached to tags instead of line numbers would help make sure that tours don't become outdated too quickly.
As a tour viewer:
As a tour author:
The text was updated successfully, but these errors were encountered: