The `rev` property has been in the initial commit that introduced `resources.json` (196203f6d76ac5240d1485dbd9701bfb026eab56) and has been added to all new entries since (always with the value `true`). This field is a remnant from back when this data was stored in a Firebase Database and the `rev` field indicated whether the entry has been reviewed/approved by a DevRel lead or something. Now that the data is kept in the repository and the reviewing is done as part of the corresponding PR, this field is no longer necessary. PR Close #37181
Contributors page
We have an official accounting of who is on the Angular Team, who are "trusted collaborators" (see https://team.angular.io/collaborators), and so on.
The contributors.json
should be maintained to keep our "org chart" in a single consistent place.
GDE listings
There are two pages:
-
https://developers.google.com/experts/all/technology/angular (Googlers: source at http://google3/googledata/devsite/content/en/experts/all/technology/angular.html) which is maintained by Dawid Ostrowski based on a spreadsheet https://docs.google.com/spreadsheets/d/1_Ls2Kle7NxPBIG8f3OEVZ4gJZ8OCTtBxGYwMPb1TUVE/edit#gid=0.
-
Ours: https://angular.io/about?group=GDE which is derived from
contributors.json
.
Alex Eagle is investigating how to reconcile these two lists.
About the data
- Keys in
contributors.json
should be GitHub handles. (Most currently are, but not all.) This will allow us to use GitHub as the default source for things like name, avatar, etc. - Pictures are stored in
aio/content/images/bios/<picture-filename>
.
Processing the data
Install https://stedolan.github.io/jq/ which is amazing.
for handle in $(jq keys[] --raw-output < aio/content/marketing/contributors.json)
do echo -e "\n$handle\n---------\n"; curl --silent -H "Authorization: token ${TOKEN}" https://api.github.com/users/$handle \
| jq ".message,.name,.company,.blog,.bio" --raw-output
done
Relevant scripts are stored in aio/scripts/contributors/
.