Open aqw opened 1 month ago
Ideas are most welcome. :-)
After some though, I prefer option 1. It's the only known use-case.
I dislike adding _date
as the type, aa the returned data will actually be date-time.
If we do eventually end up adding the other fields, I propose the following:
created
created_author
created_committer
modified
modified_author
modified_committer
I would suggest to go full namespace and not use underscores:
onyo.git.created.time # datetime
onyo.git.created.committer # these could be broken up into name and email
onyo.git.created.author
onyo.git.created.commit # commit-SHA
Especially, if we break up committer and author even further (which we kinda should, I suppose), we may also want to come up with shorter default aliases. That's where the underscores may come in handy.
onyo.created_author -> onyo.git.created.author.name
?
WDYT?
While onyo.created_author -> onyo.git.created.author.name
and others seem a bit lenghty, I think Bens idea is easier and more intuitive for the user.
I would suggest to go full namespace and not use underscores:
+1 I like this.
onyo.git.created.time # datetime
onyo.git.created.author.name
onyo.git.created.author.email
onyo.git.created.committer.name
onyo.git.created.committer.email
onyo.git.created.commit # commit-SHA
And the same stack for onyo.git.modified
. it would be metadata about the most recent modification. No need for the full history. That's what git
's commands (or onyo history
) are for.
onyo.created_author -> onyo.git.created.author.name
I think it's OK, but not great.
My ideas are: onyo.creator
and onyo.modifier
as aliases. But I'm not in love with those either.
However, we don't have alias support yet, so there's no need to decide now. And aliases will not have any guarantee of stability. Only the full name,
Implementing this in conjunction with #688, b/c it's fundamental to allow lazy loading for onyo.git.
keys in particular.
We have long discussed making various bits of git metadata queryable, most especially the creation date and last modification date.
Git already has all this information, and would support use-cases such as #428 .
The two "must haves" are creation date and last modification date. However, there is additional metadata we could expose such as committer and author (though I have no real use-cases for it).
All keys will live under the
onyo.git
namespace (see #688).Proposed names: 1) -
created
modified
2) -date_created
date_modified
3) -created_date
modified_date
4) -created_date
created_author
created_committer
modified_date
modified_author
modified_committer