git: abd7ded451c0 - main - cache: modification and last entry filling support in lockless lookup v2

[Mark Millard]

Mateusz Guzik mjg at FreeBSD.org wrote on
Sun Dec 27 21:05:01 UTC 2020 :

> The branch main has been updated by mjg:
> 
> URL: 
> https://cgit.FreeBSD.org/src/commit/?id=abd7ded451c0ddda2188b31826dc911cd22da9db
> 
> 
> commit abd7ded451c0ddda2188b31826dc911cd22da9db
> Author:     Mateusz Guzik <
> mjg at FreeBSD.org
> >
> AuthorDate: 2020-12-27 19:19:43 +0000
> Commit:     Mateusz Guzik <
> mjg at FreeBSD.org
> >
> CommitDate: 2020-12-27 21:03:18 +0000
> 
>     cache: modification and last entry filling support in lockless lookup v2
> 
> . . .


I probably would have an easier time interpreting the following
adjusted text ("vfs_" added) on https://cgit.freebsd.org/src/ :

Branch	Commit message	Author	Age
main	vfs_cache: modification and last entry filling support in lockless lookup v2	Mateusz Guzik	9 min.

instead of what actually displays:

Branch	Commit message	Author	Age
main	cache: modification and last entry filling support in lockless lookup v2	Mateusz Guzik	9 min.

All the following are not automatically very specific when I read such, even
in combination:

cache
modification
last entry fulling support
lockless lookup

so the "vfs" would have helped me.

Unfortunately, it just looks difficult to consistently have one line summaries
that well narrow down things. It is too easy to presume context not shared with
those that are just reading the text or having to make character-count tradeoffs.
If I were a committer I'd have the exact same difficulty.

===
Mark Millard
marklmi at yahoo.com
( dsl-only.net went
away in early 2018-Mar)