News for hackers. Stuff that matters.
Re:Four kinds of documentation by agumonkey on Friday October 18, 2019 @10:54AM (#21291881)
It's a bit of a generic issue. Until tail becomes a norm, it's hard to understand. I found embedded test/examples pretty great to quickly get the meaning of an idiom.

in python for instance:

    def tail(l):
        '''
        >>> tail([1,2,3])
        >>> [2,3]
        >>> tail([])
        >>> ValueException("undefined on []")
        '''
        # actual logic

There are no comments on this comment yet.