Professionelle Entwickler lernen eine neue Sprache normalerweise in 1-3 Wochen. Außer es ist neuer Sprachtyp den sie nicht kennen (wechsel zwischen imperativ, Objekt orientiert, Stack orientiert, funktional, Mengen orientiert oder eine völlig neue Syntax) Für eine umfangreiche API 1/2 - 1 Jahre. Danach können die das im Halbschlaf. "Gute" Kommentare sind so eine Sache. Anfänger schreien oft nach "guten" Kommentaren, wollen aber eigentlich schlechte Kommentare. Schlechte Kommetare sagen "was" der Code macht. Gute Kommentare sagen "warum" der Code etwas macht und zeigen kritische Stellen auf. Optimalerweise ist Code so geschrieben, daß er möglichst keine Kommentare braucht.
Auf was ich raus will: im Arduino Umfeld ist der Code fast immer so einfach, daß er leichter und schneller zu lesen ist als die Kommentare. In so einem Umfeld sind Kommentare störend. Wer umbedingt die Kommentare haben will die nur wiedergeben "was" der Code macht kann sich die auch gleich von Doxygen generieren lassen.
Was "x << y" angeht: das ist nicht immer ein Shift, vor allem bei Strings nicht. Professionelle Entwickler erwarten für einen einzelnen Operator keinen Kommentar. Auch nicht für ?:
Im empfehle für solche Fragen im Zweifelsfall das Buch "Code Complete" von McConnel.