Platform Icons
To have consistent icons for all supported platforms across all of Sentry (the product, the docs, landing pages, etc.) we created a repo for managing those icons, called platformicons.
If a new platform is added, follow these steps to add a new icon that can be used in the docs:
Add the new icon to
platformicons
:Create a new issue in the platformicons repository that specifies how the icon should be named and includes a link to the platform's website. Also, make sure to specify whether it is a top-level icon (like
python
) or a subitem that is only available in one specific platform (likepython.celery
).You can also create a PR in the
platformicons
repository where you add two versions of the icon. See the README for more info on formatting.```Release a new version of
platformicons
to NPM.If you are a Sentry employee, follow the README.md on how to do a release.
If you are not a Sentry employee, ask on our Discord server so someone can review your contribution and trigger the release.
Update the
platformicons
version used in the docs repository.Update the version of your newly released
platformicons
inpackage.json
and runyarn install
to also have the new version inyarn.lock
.Make it available as a component in the docs repository.
Update platformIcon.tsx to include your new icon. Make sure to:
- Add two imports (one for each version of the icon).
- Add the icons to
formatToSVG
. - Add a mapping for the platform and icon to
PLATFORM_TO_ICON
.
Now the new icon is available in the docs and will be used wherever icons are rendered!
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").