diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 64377230..3739a665 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -51,7 +51,7 @@ The plain and line versions (with or without wordmark) are designe The original version are only available in svg format, so they do not need to be as simple and can contain numerous colors.

-Some icons are really simple (like the Apple one), so the original version can be used as the plain version and as the icon font. In this case, you'll only need to make only one of the version (either "original" or "plain"). You can then add an alias in the devicon.json so they can be found with either the "original" or "plain" naming convention. +Some icons are really simple (like the Apple one), so the original version can be used as the plain version and as the icon font. In this case, you'll only need to make only one of the version (either "original" or "plain"). You can then add an alias in the devicon.json so they can be found with either the "original" or "plain" naming convention. Note that this only applies to font icon versions only, not the SVG versions. SVG versions don't need aliases.

@@ -94,11 +94,21 @@ Some icons are really simple (like the Apple one), so the original version can b "font": VersionString[] // list the fonts acceptable versions that you have }, "color": string, // the main color of the logo. Only track 1 color - "aliases": AliasObj[] // keeps track of the aliases + "aliases": AliasObj[] // keeps track of the aliases for the font versions ONLY } +

+ Here is what VersionString means: +

+
    +
  1. It's the version part of an `svg` file's name
    2. +
  2. If you have "html5-original", the version string would be "original"
    3. +
  3. If you have "react-line-wordmark", the version string would be "line-wordmark"
    4. +
  4. See naming conventions section for more details
    5. +
+

Here is the AliasObj interface:

@@ -110,24 +120,14 @@ Some icons are really simple (like the Apple one), so the original version can b } - -

- Here is what VersionString means: -

-
    -
  1. It's the version part of an `svg` file's name
    2. -
  2. If you have "html5-original", the version string would be "original"
    3. -
  3. If you have "react-line-wordmark", the version string would be "line-wordmark"
    4. -
  4. See Icon Formats and Naming Conventions for more details
    5. -
-
+

Example

-As an example, let's assume you have created the svgs for Amazon Web Services and Redhat logos. +As an example, let's assume you have created the svgs for Redhat and Amazon Web Services logos.

-

For the Amazon Web Services svgs, you have the following versions: "original", "original-wordmark", "plain-wordmark". However, the "original" version is simple enough to be a "plain" version as well. Note that we are not using the acronym AWS.

For the Redhat svg, you have the "original", "original-wordmark", "plain", and "plain-wordmark" versions.

+

For the Amazon Web Services svgs, you have the following versions: "original", "original-wordmark", "plain-wordmark". The "original" version is simple enough to be a "plain" version as well. Note that we are not using the acronym AWS.

  1. Put the svgs for each logo that you have into its own folders in /icons @@ -139,6 +139,33 @@ As an example, let's assume you have created the svgs for Amazon Web Services an
  2. Update the devicon.json to include the icon (or variations)