search

treehouses / treehouses.github.io

A Markdown Wiki for treehouses 🏡
http://treehouses.io
132 stars 107 forks source link

Lack of Indication that Installing Docker on User's Computer is Entirely Optional #696

Closed mattscodeans closed 4 years ago

mattscodeans commented 4 years ago

Problem

Since Docker and Docker Compose are already installed on the Raspberry Pie by default, installing Docker and Docker Compose on the user's computer is completely optional to complete the 10 steps. However, the current way the formatting is structured does not immediately indicate to the user that this installation is optional.

Steps to reproduce the problem

Visit the following link: https://treehouses.io/#!./pages/vi/dockertutorial.md

Click on Docker Installation on the left hand side navigation bar.

Notice how it is not immediately obvious to the user that Docker installation on the user's computer is optional.

Screenshots

image

Proposed solution

Replace the heading of the section "Docker Installation" with "Docker Installation (Optional)". This will immediately notify the user that installing Docker is optional.

gautamsethi1 commented 4 years ago

Definitely agree with this. I missed the part about it being optional, and didn't realize it until you pointed it out. Clearly labelling would avoid any of this confusion.