📔✨：restore handbook/styleguide/devdocs conventions

_layouts/handbook-content--g-devdocs-style.html

@@ -0,0 +1,126 @@
+---
+layout: default
+---
+
+<main role="main" class="devsite-main-content">
+  <div class="devsite-content">
+    <article class="devsite-article">
+      {%- if page.editable != false -%}
+      <div class="improve right">
+        <a href="https://github.com/openinf/.github/edit/HEAD/{{ page.path }}"
+          >Edit</a
+        >
+      </div>
+      {%- endif -%}
+      <h1 class="devsite-page-title">{{ page.title }}</h1>
+      <div class="devsite-article-body clearfix">
+        <aside id="key-point">
+          <p><strong>Key Point:</strong> {{ page.key_point }}</p>
+        </aside>
+        {{ content }}
+      </div>
+    </article>
+    <div class="devsite-content-footer nocontent">
+      <div class="row cc-footer-license">
+        <div class="license-icons">
+          <a
+            rel="license nofollow noopener noreferrer"
+            target="_blank"
+            href="https://creativecommons.org/licenses/by/4.0/"
+            title="Creative Commons Attribution 4.0 International license"
+          >
+            <img
+              class="cc-icon-cc"
+              src="https://raw.githubusercontent.com/DerekNonGeneric/loader339/main/doc/img/cc_icon.svg?sanitize=true"
+              alt="CC logo icon"
+              title="Creative Commons icon"
+            />
+            <img
+              class="cc-icon-cc-by"
+              src="https://raw.githubusercontent.com/DerekNonGeneric/loader339/main/doc/img/cc-by_icon.svg?sanitize=true"
+              alt="CC BY icon"
+              title="Attribution icon"
+            />
+          </a>
+        </div>
+        <aside>
+          <div
+            xmlns:cc="https://creativecommons.org/ns#"
+            about="https://creativecommons.org"
+          >
+            <p dir="auto">
+              <small
+                >Portions of this document are reproduced from work created and
+                <a
+                  target="_blank"
+                  href="https://developers.google.com/site-policies"
+                  title="Google Developers Site Policies"
+                  rel="nofollow noopener noreferrer"
+                  >shared by Google</a
+                >
+                and used according to terms described in
+                <a
+                  target="_blank"
+                  href="https://creativecommons.org/licenses/by/4.0/"
+                  title="Creative Commons Attribution 4.0 International license (CC BY 4.0)"
+                  rel="license nofollow noopener noreferrer"
+                  >CC BY 4.0</a
+                >. For more information, refer to the
+                <a
+                  target="_blank"
+                  href="{{ page.original_url }}"
+                  title="{{ page.original_title }}"
+                  rel="nofollow noopener noreferrer"
+                  >original source page</a
+                >.</small
+              >
+            </p>
+          </div>
+        </aside>
+      </div>
+      <div class="row cc-footer-license">
+        <div class="license-icons">
+          <a
+            rel="license nofollow noopener noreferrer"
+            target="_blank"
+            href="https://creativecommons.org/licenses/by/4.0/"
+            title="Creative Commons Attribution 4.0 International license"
+          >
+            <img
+              class="cc-icon-cc"
+              src="https://raw.githubusercontent.com/DerekNonGeneric/loader339/main/doc/img/cc_icon.svg?sanitize=true"
+              alt="CC logo icon"
+              title="Creative Commons icon"
+            />
+            <img
+              class="cc-icon-cc-by"
+              src="https://raw.githubusercontent.com/DerekNonGeneric/loader339/main/doc/img/cc-by_icon.svg?sanitize=true"
+              alt="CC BY icon"
+              title="Attribution icon"
+            />
+          </a>
+        </div>
+        <aside>
+          <div
+            xmlns:cc="https://creativecommons.org/ns#"
+            about="https://creativecommons.org"
+          >
+            <p dir="auto">
+              <small
+                >Except as otherwise noted, this content is published under
+                <a
+                  target="_blank"
+                  href="https://creativecommons.org/licenses/by/4.0/"
+                  title="Creative Commons Attribution 4.0 International license (CC BY 4.0)"
+                  rel="license nofollow noopener noreferrer"
+                  >CC BY 4.0</a
+                >.</small
+              >
+            </p>
+          </div>
+        </aside>
+      </div>
+      <p>Last updated {{ "today" | date: "%Y-%m-%d }} UTC.</p>
+    </div>
+  </div>
+</main>

collections/_docs/handbook/style/abbreviations.md

@@ -0,0 +1,112 @@
+# Abbreviations
+
+**Key Point:** Use standard American abbreviations. Avoid internet slang.
+
+Abbreviations include acronyms, initialisms, shortened words, and contractions.
+
+- An acronym is formed from the first letters of words in a phrase, but is
+  pronounced as if it were a word itself:
+  - _NATO_ for _North Atlantic Treaty Organization_.
+  - _scuba_ for _self-contained underwater breathing apparatus_.
+- An initialism is also formed from the first letters of words in a phrase, but
+  each letter is pronounced separately:
+  - _CIA_ for _Central Intelligence Agency_.
+  - _FYI_ for _For Your Information_.
+  - _PR_ for _Public Relations_.
+- A shortened word is just part of a word or phrase, sometimes with a period at
+  the end:
+  - _Dr._ for _doctor_.
+  - _etc._ for _et cetera_.
+  - _min_ for _minutes_.
+  - _CA_ for _California_.
+- [Contractions](contractions.md) are discussed in a separate page of this style
+  guide.
+
+There's some overlap among those categories. In particular, some abbreviations
+can be either acronyms or initialisms, depending on the speaker's preference;
+examples include _FAQ_ and _SQL_. In some cases, the pronunciation determines
+[whether to use "a" or "an."](articles.md)
+
+## Long and short versions of a word
+
+Some words have a long version and a short version. Examples include:
+
+- _application_ and _app_
+- _demonstration_ and _demo_
+- _synchronize_ and _sync_
+
+The short versions of the words are not abbreviations, and if you use them, you
+don't need to put a period after them.
+
+If you're not sure whether a word is an abbreviation or just a short version of
+a longer word, look in our list of [resources](resources.md). If that doesn't
+settle the issue, use the speaking test: if you speak the short version as a
+word ("This is a demo version of the product"), you can usually treat it as a
+word and not an abbreviation.
+
+## When to spell out a term
+
+In general, when an abbreviation is likely to be unfamiliar to the audience,
+spell out the first mention of the term in the text (not in a heading) and
+immediately follow with the abbreviation, in parentheses. For all subsequent
+mentions of the abbreviation, use the abbreviation by itself.
+
+When deciding to spell out a term, consider your audience. If the majority of
+your audience is likely to recognize and understand the term, then you don't
+need to spell it out. For example, if you're writing documentation for
+developers that references an API, you don't need to spell out _application
+programming interface_. However, if you're explaining the general concept of an
+API to someone with no programming experience, spelling out the abbreviation can
+be helpful.
+
+In some cases, spelling out a term doesn't help the reader understand the term.
+For example, writing out _portable document format_ doesn't help the reader
+understand what a _PDF_ document is. In those cases, don't spell out the term.
+
+The following abbreviations rarely need to be spelled out:
+
+- API
+- DVD
+- File formats such as PDF or XML
+- HTML
+- PC
+- RAM
+- REST
+- [Units of measurement](units-of-measure.md) such as _MB_ or _GB_
+- URL
+- USB
+
+## Abbreviations not to use
+
+Prefer English terms over Latin abbreviations. Don't use "i.e." or "e.g.";
+instead, use "that is" or "for example," respectively. One exception: it's
+[okay to use "etc." in some circumstances](word-list.md#etc).
+
+Don't use internet slang abbreviations such as "[tl;dr](word-list.md#tldr),"
+"[ymmv](word-list.md#ymmv)," "[RTFM](word-list.md#rtfm)," or others. Write out
+what you mean in a non-figurative way.
+
+Use the most common form of a word. If the full spelled-out word is common and
+easily understandable, use that rather than abbreviating. For example, write
+"approximately" instead of "approx."
+
+## Periods with abbreviations
+
+Follow these guidelines:
+
+- Don't use periods with acronyms or initialisms.
+- Put a period at the end of a shortened word, except for
+  [date and time](dates-times.md) abbreviations.
+- If you write or say an abbreviation as a word (for example, "app" or "sync"),
+  don't put a period after it.
+- Don't use a period with an abbreviation for the name of a country, US state,
+  or the District of Columbia (DC).
+
+---
+
+<small>Portions of this page are reproduced from work created and
+[shared by Google](https://developers.google.com/readme/policies/) and used
+according to terms described in the
+[Creative Commons 4.0 Attribution License](https://creativecommons.org/licenses/by/4.0/).
+For more information, refer to the
+[original source page](https://developers.google.com/style/abbreviations).</small>