Files
Joe Martin (Crowdstaffing) 42289f25c6 docs: improve markdown (#45325)
The purpose of the changes is to clean all markdown to match a single pedantic style.

*   To ensure all changes in style are properly separated.
*   To ensure all styled content aligns to nearest 4-character-tab.
*   To ensure all code blocks use the Angular `<code-example>` or `<code-tab>` elements.
*   To ensure all markdown exists outside of html tags.
*   To ensure all images use the Angular style for `<img>` elements.
*   To ensure that all smart punctuation is replaced or removed.

    ```text
    ’, ’, “, ”, –, —, …
    ```

*   To ensure all content does not conflict with the following reserved characters.

    ```text
    @, $, *, &, #, |, <, >,
    ```

*   To ensure all content displays using html entities.

The following changes were made to files in the following directory.

```text
aio/content
```

The target files were markdown files.
The list of excluded files:

```text
.browserslistrc, .css, .conf, .editorconfig, .gitignore, .html, .js, .json, .sh, .svg, .ts, .txt, .xlf,
```

PR Close #45325
2022-04-08 19:36:30 +00:00

1.8 KiB

Contributors page

We have an official accounting of who is on the Angular Team (see https://angular.io/about?group=Angular), who are "trusted collaborators" (see https://angular.io/about?group=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:

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.

  • Keys are sorted in alphabetical order, please keep the sorting order when adding new entries.

  • 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/.