You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
It seems a bit useless to be inserting links to people every place they're mentioned when this information is already stored in contributors.toml. It would be useful to be able to write {{#person Fredrik Bakke}} in place of [Fredrik Bakke](my preferred website). This also makes it easier to maintain one's preferred website later without touching every file one is mentioned in.
Note that the extended scope of including arbitrary people is useful here. For instance, we have many mentions of Freek Wiedijk, who is not a contributor.
The text was updated successfully, but these errors were encountered:
I've been thinking of finally replacing the git-based authorship attribution process with an in-file explicit macro-based one. My initial though was to have an {{#authors author1, author2, author3}}, because we could easily change the format of the message and sort the authors alphabetically. Do you have an opinion if it's better to have that macro be independent, or if it should rather be written explicitly as "Content created by {{#person author1}} and {{#person author2}}"?
It sounds to me like we should have two macros, one for authors and one for persons, but it would make sense to have both run as part of the same script. Perhaps we can even extend the latter to "entities", so we can cite projects and other things as "people" too?
It is useful to have a dedicated authors macro, because then we can automatically detect and warn a contributor if they're not adding themselves to the author lists of the files they're adding to.
It seems a bit useless to be inserting links to people every place they're mentioned when this information is already stored in
contributors.toml
. It would be useful to be able to write{{#person Fredrik Bakke}}
in place of[Fredrik Bakke](my preferred website)
. This also makes it easier to maintain one's preferred website later without touching every file one is mentioned in.Note that the extended scope of including arbitrary people is useful here. For instance, we have many mentions of Freek Wiedijk, who is not a contributor.
The text was updated successfully, but these errors were encountered: