Revert "Add "Design decisions for paths" section."

This reverts commit bc482f0dbae3334e10e2e61ed6e84b6ca68f9d3e for path.hpp

Then add "Design decisions for paths" section docs changes