From 23c187639ec916ee28b02270a77221a6ffaad530 Mon Sep 17 00:00:00 2001 From: Jan Engelhardt Date: Thu, 5 Jun 2025 09:00:21 +0200 Subject: [PATCH] Remove animal icons at start of intro boxes Sometimes, icons may be used for a `
` box to indicate some sort of summary category/severity level of the paragraph, cf. e.g. . Or, as a special case, used to obtain a copyable link, e.g. in the section headers of . Animal icons do not fall in either those two uses, and the GF Guide should not mimic school paper notes where someone was bored and drew doodles. --- gf-guide/article.md | 2 +- gf-guide/authors.md | 2 +- gf-guide/axis-registry.md | 2 +- gf-guide/build.md | 2 +- gf-guide/culture.md | 2 +- gf-guide/diacritics.md | 2 +- gf-guide/fonttables.md | 2 +- gf-guide/googlefonts.md | 2 +- gf-guide/hosting.md | 2 +- gf-guide/index.md | 2 +- gf-guide/lang.md | 2 +- gf-guide/license-file.md | 2 +- gf-guide/maintaining.md | 2 +- gf-guide/making-pr.md | 2 +- gf-guide/metadata.md | 2 +- gf-guide/metrics.md | 2 +- gf-guide/onboarder-workflow.md | 2 +- gf-guide/onboarding.md | 2 +- gf-guide/outlines.md | 2 +- gf-guide/package.md | 2 +- gf-guide/production.md | 2 +- gf-guide/profile.md | 2 +- gf-guide/promotion.md | 2 +- gf-guide/qa.md | 2 +- gf-guide/readmefile.md | 2 +- gf-guide/requirements.md | 2 +- gf-guide/statics.md | 2 +- gf-guide/tags.md | 2 +- gf-guide/testing.md | 2 +- gf-guide/tools.md | 2 +- gf-guide/upstream.md | 2 +- gf-guide/variable.md | 2 +- 32 files changed, 32 insertions(+), 32 deletions(-) diff --git a/gf-guide/article.md b/gf-guide/article.md index 1f17c1c..9fa2962 100644 --- a/gf-guide/article.md +++ b/gf-guide/article.md @@ -7,7 +7,7 @@
-🦉 Both the ARTICLE.en_us.html and DESCRIPTION.en_us.html files are used to bring the information that appears in the #About section on any specimen page of Google Fonts to provide further information about the font family. +Both the ARTICLE.en_us.html and DESCRIPTION.en_us.html files are used to bring the information that appears in the #About section on any specimen page of Google Fonts to provide further information about the font family.

The team member onboarding the font will create any of these files. Thus, the actual file a designer should write carefully is the README.md file of the font's repository, as the information in it will be crucial to create a descriptive #About section. diff --git a/gf-guide/authors.md b/gf-guide/authors.md index dde2708..8e3e5e8 100644 --- a/gf-guide/authors.md +++ b/gf-guide/authors.md @@ -7,7 +7,7 @@
-🦤 Authors and contributors are people or industries participating into a project either because they paid for it, they employed people who created and produced it, or because they are the people who made it. +Authors and contributors are people or industries participating into a project either because they paid for it, they employed people who created and produced it, or because they are the people who made it.
  • The list of authors generally includes the creators and all the possible copyright holders (such as the company employing the actual creators). This may differ according to the copyright laws of the author’s country; better to inform yourself if the project was commissioned by an instiution or a company.
    • diff --git a/gf-guide/axis-registry.md b/gf-guide/axis-registry.md index af77c31..6c3ac90 100644 --- a/gf-guide/axis-registry.md +++ b/gf-guide/axis-registry.md @@ -7,7 +7,7 @@
    -🕷 Type designers are familiar with the five axes already defined by Microsoft in the OpenType specification. However, for each new variable font that type designer develops, it often introduces new axes. In order for a family introducing new custom axes to be added to the Google Fonts API and Catalog, each axis it offers must be “registered” – it must have a definition in the GF Axis Registry. +Type designers are familiar with the five axes already defined by Microsoft in the OpenType specification. However, for each new variable font that type designer develops, it often introduces new axes. In order for a family introducing new custom axes to be added to the Google Fonts API and Catalog, each axis it offers must be “registered” – it must have a definition in the GF Axis Registry.

    The requirements and principles of axis definition have been established mainly by a cross-functional group of fonts team members by Q3 2022. This protocol provides a guide to handling it within the font project as part of the onboarding process to Google Fonts. It offers detailed information on the required information, how to define it, and the required steps. diff --git a/gf-guide/build.md b/gf-guide/build.md index cc7de4a..1c22e46 100644 --- a/gf-guide/build.md +++ b/gf-guide/build.md @@ -7,7 +7,7 @@
    -🦕 Because of our commitment to Libre font culture, all Google Fonts projects must be built using a reproducible, libre toolchain. We do not onboard binaries exported from font editors. +Because of our commitment to Libre font culture, all Google Fonts projects must be built using a reproducible, libre toolchain. We do not onboard binaries exported from font editors. This chapter aims to guide designers in building their font binaries using open-source tools as per our production requirements. Everything related to font file settings is detailed in the Pre-production section of this guide, and for practicality, that information will not be repeated here.

    diff --git a/gf-guide/culture.md b/gf-guide/culture.md index 2d3e240..0789363 100644 --- a/gf-guide/culture.md +++ b/gf-guide/culture.md @@ -7,7 +7,7 @@
    -🦉 The design community and the tech community traditionally have very different cultures. Designer culture often involves the work of a single artist-designer that usually prefers to protect their artwork, while software developers generally cannot operate in such a solitary fashion: their work, even if it is copyrighted, is often based on the work of others and more subject to fragmented authorship. +The design community and the tech community traditionally have very different cultures. Designer culture often involves the work of a single artist-designer that usually prefers to protect their artwork, while software developers generally cannot operate in such a solitary fashion: their work, even if it is copyrighted, is often based on the work of others and more subject to fragmented authorship.

    Since fonts are software, Google Fonts works at the intersection of the two communities and, for many reasons, has embraced the Libre software culture to promote the creation, development, and distribution of typefaces. This culture encourages participation and learning while facilitating sharing and collaboration through the openness of the work and a more flexible licensing schema.

    diff --git a/gf-guide/diacritics.md b/gf-guide/diacritics.md index 5efa6fa..eb233c6 100644 --- a/gf-guide/diacritics.md +++ b/gf-guide/diacritics.md @@ -7,7 +7,7 @@
    -🐳 A diacritic is a mark used in combination with a base letter for many purposes, such as modifying the pronunciation by extending a basic alphabet to include more phonemes; adding stress that could differentiate similar words, hence meanings; and, in some languages, adding or modifying a vowel in a word. +A diacritic is a mark used in combination with a base letter for many purposes, such as modifying the pronunciation by extending a basic alphabet to include more phonemes; adding stress that could differentiate similar words, hence meanings; and, in some languages, adding or modifying a vowel in a word.

    Many diacritics are separated from the base letter, and can be placed above, below, aside, or through it; while other diacritics connect to the base.

    diff --git a/gf-guide/fonttables.md b/gf-guide/fonttables.md index 1c4ac91..f48c705 100644 --- a/gf-guide/fonttables.md +++ b/gf-guide/fonttables.md @@ -7,7 +7,7 @@
    -🦦 Understanding the what are the font tables and what they do is a core skill in font engineering. +Understanding the what are the font tables and what they do is a core skill in font engineering.

    You can view the name tables using these tools:
      diff --git a/gf-guide/googlefonts.md b/gf-guide/googlefonts.md index e97df18..adeb6f8 100644 --- a/gf-guide/googlefonts.md +++ b/gf-guide/googlefonts.md @@ -7,7 +7,7 @@
      -🦉 google/fonts is the GitHub repository that is used as a staging area to upload font families to Google Fonts. +google/fonts is the GitHub repository that is used as a staging area to upload font families to Google Fonts.

      Once your project is ready, and you are sure it meets all the font and production requirements; as well as you have located your files in a GitHub repository that follows the required structure, then the definitive step to contributing your font to Google Fonts is to submit it as a Pull Request to google/fonts repository.

      diff --git a/gf-guide/hosting.md b/gf-guide/hosting.md index e434031..d2147a9 100644 --- a/gf-guide/hosting.md +++ b/gf-guide/hosting.md @@ -6,7 +6,7 @@ {:.no_toc}
      -🐰 Git +Git
      Git is an open-source Version Control System (VCS) that runs on your local machine. It is a powerful tool that allows you to save discrete versions of a project as you work on it and makes it possible for collaborators to work together on code-based projects (including fonts) in a controlled manner. Using Git is essential to track the history of a project. diff --git a/gf-guide/index.md b/gf-guide/index.md index 113a61a..8bcbb19 100644 --- a/gf-guide/index.md +++ b/gf-guide/index.md @@ -4,7 +4,7 @@
      -🦜 This guide aims to help people navigate the requirements and recommendations for contributing to Google Fonts. The contents covered here range from general knowledge to contextualize the what and why of some of the requirements as well as the specifics regarding technical aspects with some suggestions on how to comply with them. It covers different levels of information for both newcomers and more experienced contributors. +This guide aims to help people navigate the requirements and recommendations for contributing to Google Fonts. The contents covered here range from general knowledge to contextualize the what and why of some of the requirements as well as the specifics regarding technical aspects with some suggestions on how to comply with them. It covers different levels of information for both newcomers and more experienced contributors. Therefore, this documentation is not meant to be read at once. If you are already familiar with some of the concepts, for example, some people are more empowered with the use of Github please you can skip some chapters and jump to the other bits that you may be looking for. The guidelines have been separated into small bits to facilitate the search of specific information that you would need at a specific stage of the font production. diff --git a/gf-guide/lang.md b/gf-guide/lang.md index 881a47f..3c75a6f 100644 --- a/gf-guide/lang.md +++ b/gf-guide/lang.md @@ -6,7 +6,7 @@ {:.no_toc}
      -🦜 googlefonts/lang is the GitHub repository that defines the foundation for the *lang metadata system* +googlefonts/lang is the GitHub repository that defines the foundation for the *lang metadata system*

      This section specifies the main concepts of the system and provides information on how if influences the displaying of the font in the Catalog.
      diff --git a/gf-guide/license-file.md b/gf-guide/license-file.md index 2302886..fa60a03 100644 --- a/gf-guide/license-file.md +++ b/gf-guide/license-file.md @@ -7,7 +7,7 @@
      -🐰 Google initially accepted several libre licenses such as OFL, UFL and Apache. +Google initially accepted several libre licenses such as OFL, UFL and Apache. But today only the OFL is accepted, and that has been the case for many years now.

      This page flags some important requirements about the OFL license, as well as a template to copy-paste into your repo. diff --git a/gf-guide/maintaining.md b/gf-guide/maintaining.md index 4564ebd..7a0aba3 100644 --- a/gf-guide/maintaining.md +++ b/gf-guide/maintaining.md @@ -7,7 +7,7 @@
      -🐰 A font is not finished just because it has been released. From time to time, you may want to update your design; users may find and report issues with the font that need to be addressed, or Google may commission you to update your own or someone else’s font. +A font is not finished just because it has been released. From time to time, you may want to update your design; users may find and report issues with the font that need to be addressed, or Google may commission you to update your own or someone else’s font.

      This guide will help designers to adopt good habits while maintaining their work within a GitHub repository. diff --git a/gf-guide/making-pr.md b/gf-guide/making-pr.md index ceb78ae..ea674b8 100644 --- a/gf-guide/making-pr.md +++ b/gf-guide/making-pr.md @@ -7,7 +7,7 @@
      -🐸 In order to submit a new family or an upgrade of an existing family on fonts.google.com, we must add or update the files held in the google/fonts repository. This guide will help users submit Pull Requests (PR) which can then be reviewed and merged by a team member. +In order to submit a new family or an upgrade of an existing family on fonts.google.com, we must add or update the files held in the google/fonts repository. This guide will help users submit Pull Requests (PR) which can then be reviewed and merged by a team member.