More than Just Lines on a Map: Best Practices for U.S Bike Routes
SourceCodeTourGuide
1. System Browser
n Shows everything
n Things are sorted by name
n Does not tell story
2. System Browser
show everything
n As a tourist, you don’t need to visit every city,
every building, every street, every soil.
n Visiting everywhere is...
n waste of time
n waste of engery
n meaningless
3. System Browser
sorted by name
n destroys the context
Once upon a time there were Once They They a a a a frogs.
three frogs. They lived in a good had in in lived lived
swamp. They had a good time swamp. swamp. the there
there. a troll too lived in the there. three time time too troll
swamp. upon were
4. System Browser
sorted by name
n helps one who knows the name
n good for one who does not need help
n bad for one who needs help
5. System Browser
does not tell story
n It is hard to understand when you don’t know
big picture.
n Class comments, method comments are
isolated dots of info.
6. TourGuide
n Select & Focus
n Efficient tour course
n Tells story
8. Use cases
n case1: Orientation for new team member.
n case2: Bookmark for developing interest.
n case3: Journal for code study.
n case4: Tool for conference presenter who wants to
explain the code without any mistakes.