docs: improved documentation for compiling and disambiguated comments about GPIO numbers vs pin numbers