added changes from main

creativecommons · Oct 17, 2024 · f0db3c7 · f0db3c7
2 parents e87dbd9 + 992a862
commit f0db3c7
Show file tree

Hide file tree

Showing 6 changed files with 55 additions and 9 deletions.
diff --git a/content/contributing-code/documentation-guidelines/contents.lr b/content/contributing-code/documentation-guidelines/contents.lr
@@ -0,0 +1,43 @@
+_model: page
+---
+_template: page-with-toc.html
+---
+title: Documentation Guidelines
+---
+description: This Documentation Guidelines (style guide) ensures all the files in all repositories and any other documentation are properly documented.
+---
+body:
+
+# Documentation guidelines
+
+The purpose of this guideline is to provide a step-by-step framework for writing and maintaining high-quality documentation for Creative Commons (CC) projects. This guide covers essential sections such as project style guide Preference, Style modification, terminologies, markdown usage. Following these guidelines ensures consistency, clarity, and ease of use for all contributors and users.
+
+## Style guide reference
+
+For general writing style and guidelines, refer to the following upstream style guides:
+
+- [Google Developer Style Guide (Preferred)](https://developers.google.com/style/)
+- [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/)
+
+## Style preferences modifications
+
+While adhering to the upstream style guides, observe the following modifications:
+- All acronyms must be defined on first use
+- Use active voice wherever possible to improve clarity and engagement.
+- Keep sentences concise and to the point, avoiding jargon unless necessary.
+
+
+## Terminology
+
+Establishing a clear "Terminology" section for Creative Commons (CC)-specific usage is crucial. Below are some proprietary terms and their usage:
+
+- **Creative Commons (CC)**: A non-profit organization enabling sharing and reuse of creative works.
+- **Licenses**: Legal tools that allow creators to specify how their works can be used.
+- **Attribution**: Giving credit to the creator of a work, required by most CC licenses.
+
+
+## Markdown usage
+This section provides guidelines for using Markdown in documentation:
+- For comprehensive documentation on GitHub-flavored Markdown, refer to the [GitHub Markdown Guide](https://docs.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax).
+- For additional information on the specific Markdown implementation used in Lektor, visit the [Lektor Markdown Documentation](https://www.getlektor.com/docs/content/#markdown).
+- Note: Use code block markup for instructions on installation, deployment, and development, especially to write code commands.
diff --git a/content/programs/contents.lr b/content/programs/contents.lr
@@ -22,22 +22,20 @@ CC isn't currently participating in Google Season of Docs (GSoD).
 
 ### Google Summer of Code
 
-CC is applying for participation in Google Summer of Code (GSoC) 2024.
+CC will apply for participation in Google Summer of Code (GSoC) 2025.
 
 - [Program website](https://summerofcode.withgoogle.com/)
 
 <!--
-- [CC's GSoC 2024 page][gsoc2024cc]
+- [CC's GSoC 2025 page][gsoc2025cc]
 
-[gsoc2024cc]: https://summerofcode.withgoogle.com/programs/2024/organizations/creative-commons
+[gsoc2025cc]: https://summerofcode.withgoogle.com/programs/2025/organizations/creative-commons
 -->
 
 
 ### Outreachy
 
-CC isn't participating in the May 2024 internships.
-
-CC will participate in the December 2024 internships.
+CC is participating in the December 2024 cohort.
 
 - [Program website](https://www.outreachy.org/)
 - [CC's Outreachy page][outreachycc]

diff --git a/databags/repos.json b/databags/repos.json
@@ -473,7 +473,7 @@
             "english_name": "CC Legal Database",
             "featured": false,
             "id": 133715391,
-            "language": "HTML",
+            "language": "CSS",
             "license": {
                 "name": "MIT License",
                 "url": "https://github.com/creativecommons/legaldb/blob/main/LICENSE"

diff --git a/themes/vocabulary_theme/templates/layout.html b/themes/vocabulary_theme/templates/layout.html
@@ -1,4 +1,5 @@
 <!doctype html>
+<html lang="en">
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="shortcut icon" type="image/x-icon" href="{{ '/static/favicon.ico'|url }}">
@@ -46,7 +47,7 @@
   <header class="container">
     <nav class="navbar">
       <div class="navbar-brand">
-        <a class="has-text-black" href="{{ '/'|url }}">
+        <a class="has-text-black" href="{{ '/'|url }}" aria-label="Home">
           <svg
             class="logo margin-top-small"
             xmlns="http://www.w3.org/2000/svg"
@@ -78,6 +79,7 @@
                 ['/contributing-code/github-repo-guidelines', 'GitHub Repo Guidelines'],
                 ['/contributing-code/repo-labels', 'Repository Labels'],
                 ['/contributing-code/foundational-tech', 'Foundational technologies'],
+                ['/contributing-code/documentation-guidelines', 'Documentation Guidelines'],
                 ['/contributing-code/javascript-guidelines', 'JavaScript Guidelines'],
                 ['/contributing-code/python-guidelines', 'Python Guidelines'],
                 ['/contributing-code/translation-guide', 'Translation Guide'],
@@ -271,3 +273,4 @@ <h5>Our work relies on you!</h5>
     </div>
   </footer>
 </body>
+</html>
diff --git a/themes/vocabulary_theme/templates/macros/authors_gravatar.html b/themes/vocabulary_theme/templates/macros/authors_gravatar.html
@@ -8,7 +8,7 @@
     {% if post.author|length >= 2 %}
         <img class="profile" src="/multiple-authors.jpg" alt="multiple authors image"/>
     {% else %}
-        <img class="profile" src="https://secure.gravatar.com/avatar/{{ current_author.md5_hashed_email }}?size=200&d=mp" alt="gravatar" />
+        <img class="profile" src="https://secure.gravatar.com/avatar/{{ current_author.md5_hashed_email }}?size=200&d=mp" alt="author's gravatar" />
     {% endif %}
       </figure>
     </header>

diff --git a/themes/vocabulary_theme/templates/page-with-toc.html b/themes/vocabulary_theme/templates/page-with-toc.html
@@ -30,9 +30,11 @@ <h1>{{ this.title }}</h1>
                     {% if (href == '/contributing-code') %}
                       <ul>
                       {% for href, title in [
+                        ['/contributing-code/foundational-tech', 'Foundational technologies'],
                         ['/contributing-code/pr-guidelines', 'Pull Request Guidelines'],
                         ['/contributing-code/github-repo-guidelines', 'GitHub Repo Guidelines'],
                         ['/contributing-code/repo-labels', 'Repository Labels'],
+                        ['/contributing-code/documentation-guidelines', 'Documentation Guidelines'],
                         ['/contributing-code/javascript-guidelines', 'JavaScript Guidelines'],
                         ['/contributing-code/python-guidelines', 'Python Guidelines'],
                         ['/contributing-code/translation-guide', 'Translation Guide'],