Explaining what a method does:
"""Python has docstrings"""
/** Java has javadocs */

Seriously Apple...

  • 4
    Ya the comment explanation itself become a method name.. 😂
  • 1
    You save a linebreak... ¯\_(ツ)_/¯
  • 0
    @davidmaamoaix you know what I mean.
  • 2

    // Was trying to figure out how to upload an image without it spanning the whole width of the comment section.
  • 3
    "Self documenting code"
  • 1
    Swift has the triple slash syntax for documentation:
    ///doc here

    But you know what? Long names is better than doc comments!

    By that logic, it would be good practice to have one letter names everywhere because it is short and you can read the doc if you want to know what it means.
  • 0
    Isnt java the same? I encountered lots of long-sentenced function name.. 😅
Add Comment