search

reactivemarkets / toolbox-cpp

The Reactive C++ Toolbox is an open source library of C++20 components designed for efficient, asynchronous network applications on the Linux platform.
https://reactivemarkets.github.io/toolbox-cpp/
Other
21 stars 20 forks source link

Change subdomain to docs #11

Closed markaylett closed 5 years ago

markaylett commented 5 years ago

Change the documentation subdomain from doc to docs.

markaylett commented 5 years ago

I must admit that I find myself going around in circles with this singular vs. plural debate. I've always gone with the Unix and SQL standard of singular directory and table names. E.g. bin, home, lib, log, opt, var, etc. But there's a definite trend towards plurals from the younger Internet crowd. It's pointless me trying to fight the trend, of course, but there are two issues with plural names that irk me: 1) Use of plural names for all sub-directories of a path feels awkward and redundant. E.g. /usrs/shares/docs/html, and 2) it raises immediate questions regarding the correct plural form: is it html or htmls? usr or usrs? fish or fishes?

rfernandes commented 5 years ago

Singular is prefered, some people may have been take to perfering plural because of REST endpoints and similar influences (I'm looking at you Windows), but as you pointed out /usr/share/doc is the unix convention.