On 06/13/2017 10:14 AM, C. Scott Ananian wrote:
On Jun 13, 2017 6:24 AM, "Gergo Tisza"
<gtisza(a)wikimedia.org> wrote:
On Tue, Jun 13, 2017 at 7:11 AM, Subramanya Sastry <ssastry(a)wikimedia.org>
wrote:
I find these annotations misleading and wonder
why they exist and what
purpose they serve.
It can sometimes tell you whom to ask for advice
or reviews. (git log would too but it's more effort.)
For the record (since one of my patches was specifically mentioned) Gergo's
reason matches mine. This is common (if informal) practice for a number of
open source software projects---a way to easily indicate the original
author of the code, as a pointer to who to ask if you've got questions
about it. T
I think the @author tag is at best a documentation hack for this
scenario. What happens when people leave the project or there are more
than one person who understands that code, or expertise shifts with
changing codebase?
It would be better to actually add a documentation line to point to a
wiki page where this information can be found (and kept up to date).
Subbu.