Re: [PATCH] doc: clarify that notes can be attached to any type of stored object

From: Junio C Hamano <gitster@pobox.com>
Date: Apr 4, 2016, 16:39 UTC
Message-ID: <xmqqy48t5nvo.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <CAHGBnuP71qpOoNAAwXE-nbPbVyK56Up0YpmhhjC5430VwW73kQ@mail.gmail.com>

Sebastian Schuberth <sschuberth@gmail.com> writes:

> Done, I'll send a patch shortly. But I wanted to list the supported
> object types explicitly, in particular as many guide in the net are
> unclear that only annotated tags are object, and lightweight ones are
> not.

I'd really hate to see an explicit list of what object types there are, as it is one more place we'd need to update if we ever add new object types (and we are unlikely to do so anytime soon, which makes it even more likely that we would forget there is this explicit list we'd need to update).

-     Adds, removes, or reads notes attached to objects, without touching
-     the objects themselves.
+     Adds, removes, or reads notes attached to any object (not limited
+     to commit objects), without touching the objects themselves.

should be sufficient, no?