From 72ab892750c247d1311a78dd7a7e99a35e256331 Mon Sep 17 00:00:00 2001 From: Muluh MG Godson Date: Mon, 3 May 2021 22:47:36 +0100 Subject: [PATCH 1/2] Content: added categories for related articles --- content/communities/fedora.en.adoc | 1 + content/communities/public-lab.en.adoc | 1 + content/data/milestone-roadmap.en.adoc | 1 + content/data/model-card.en.adoc | 1 + content/data/traps.en.adoc | 1 + content/design/reading-list.en.adoc | 1 + content/dev-tools/continuous-integration.en.adoc | 1 + content/documentation/frontier-tech-tips.en.adoc | 1 + content/documentation/hall-of-fame.en.adoc | 1 + content/documentation/reading-list.en.adoc | 1 + content/documentation/text-editors.en.adoc | 1 + content/foss/_index.en.adoc | 1 + content/foss/business-sustainability.adoc | 1 + content/foss/contributor-license-agreement-cla.en.adoc | 1 + content/foss/governance.adoc | 1 + content/foss/gpl-comparison.en.adoc | 1 + content/foss/reading-list-foss.en.adoc | 1 + content/foss/reading-list-legal.en.adoc | 1 + content/foss/reading-list-outreach.en.adoc | 1 + content/hardware/case-studies.en.adoc | 1 + content/hardware/documentation.en.adoc | 1 + content/hardware/intro.en.adoc | 1 + content/hardware/licensing.en.adoc | 1 + content/hardware/projects.en.adoc | 1 + content/hardware/reading-list.en.adoc | 1 + content/meta/modules.en.adoc | 1 + content/meta/needs-assessment-template.en.adoc | 1 + content/meta/overview.en.adoc | 1 + content/meta/templates.en.adoc | 1 + content/meta/workflow-metrics.en.adoc | 1 + content/meta/workplan-bridge-funding.en.adoc | 1 + content/missions/codes-of-conduct.en.adoc | 1 + content/missions/good-first-issue.en.adoc | 1 + content/project-management/issue-templates.en.adoc | 1 + content/project-management/project-boards.en.adoc | 1 + content/project-management/reading-list.en.adoc | 1 + content/reproducibility/_index.en.adoc | 1 + content/reproducibility/reading-list.en.adoc | 1 + 38 files changed, 38 insertions(+) diff --git a/content/communities/fedora.en.adoc b/content/communities/fedora.en.adoc index ce89468d..904a9b1d 100644 --- a/content/communities/fedora.en.adoc +++ b/content/communities/fedora.en.adoc @@ -3,6 +3,7 @@ title: Fedora Project weight: 50 description: The Fedora Project is a community of people working together to build a free and open source operating system. tags: ["linux"] +categories: "communities" --- :toc: diff --git a/content/communities/public-lab.en.adoc b/content/communities/public-lab.en.adoc index 4fae9f5b..eb6c9bbf 100644 --- a/content/communities/public-lab.en.adoc +++ b/content/communities/public-lab.en.adoc @@ -3,6 +3,7 @@ title: Public Lab weight: 100 description: Public Lab is a community and a non-profit, democratizing science to address environmental issues that affect people. tags: ["citizen science", "environment"] +categories: "communities" --- diff --git a/content/data/milestone-roadmap.en.adoc b/content/data/milestone-roadmap.en.adoc index 55a4e576..f621e822 100644 --- a/content/data/milestone-roadmap.en.adoc +++ b/content/data/milestone-roadmap.en.adoc @@ -3,6 +3,7 @@ title: "AI Ethics & Transparency Roadmap - Template" weight: 10 description: How do you document your machine learning development process? This guide shares transparency best practices. tags: ["template"] +categories: "data" --- diff --git a/content/data/model-card.en.adoc b/content/data/model-card.en.adoc index 6658da1f..4c370875 100644 --- a/content/data/model-card.en.adoc +++ b/content/data/model-card.en.adoc @@ -3,6 +3,7 @@ title: "Machine Learning Model Card" weight: 20 description: Model cards help you document how your model was made. Use this overview to make your own model cards. tags: ["design", "template"] +categories: "data" --- diff --git a/content/data/traps.en.adoc b/content/data/traps.en.adoc index c37761c3..60a1ded8 100644 --- a/content/data/traps.en.adoc +++ b/content/data/traps.en.adoc @@ -3,6 +3,7 @@ title: "Common traps to avoid when building AI systems" weight: 30 description: Assessing common AI/ML mistakes that lead to unintended side effects. tags: ["design"] +categories: "data" --- _Assessing common mistakes that lead to unintended side effects._ diff --git a/content/design/reading-list.en.adoc b/content/design/reading-list.en.adoc index fe6d6bfe..1c8b9569 100644 --- a/content/design/reading-list.en.adoc +++ b/content/design/reading-list.en.adoc @@ -3,6 +3,7 @@ title: "Design & UX Reading List" weight: 10 description: Various readings and learnings about design in an Open Source context. tags: ["reading list"] +categories: "design" --- diff --git a/content/dev-tools/continuous-integration.en.adoc b/content/dev-tools/continuous-integration.en.adoc index 1d1c356d..49fb80c1 100644 --- a/content/dev-tools/continuous-integration.en.adoc +++ b/content/dev-tools/continuous-integration.en.adoc @@ -3,6 +3,7 @@ title: "Continuous Integration (CI)" weight: 10 description: An introduction to creating a Continuous Integration (CI) pipeline for an Open Source project. tags: ["testing"] +categories: "dev-tools" --- diff --git a/content/documentation/frontier-tech-tips.en.adoc b/content/documentation/frontier-tech-tips.en.adoc index b034a4b4..481471f2 100644 --- a/content/documentation/frontier-tech-tips.en.adoc +++ b/content/documentation/frontier-tech-tips.en.adoc @@ -3,6 +3,7 @@ title: "Frontier technology tips" weight: 10 description: A summary of Andrew Burden's DevConf 2020 talk about best practices for documenting emerging technology. tags: ["innovation"] +categories: "documentation" --- diff --git a/content/documentation/hall-of-fame.en.adoc b/content/documentation/hall-of-fame.en.adoc index 1e590184..51c33944 100644 --- a/content/documentation/hall-of-fame.en.adoc +++ b/content/documentation/hall-of-fame.en.adoc @@ -3,6 +3,7 @@ title: Documentation Hall of Fame weight: 20 description: Real examples of Open Source projects with excellent documentation. tags: ["hall of fame"] +categories: "documentation" --- :toc: diff --git a/content/documentation/reading-list.en.adoc b/content/documentation/reading-list.en.adoc index 08da1b03..79ce7c22 100644 --- a/content/documentation/reading-list.en.adoc +++ b/content/documentation/reading-list.en.adoc @@ -3,6 +3,7 @@ title: "Reading list" weight: 30 description: Various readings and learnings about documentation in an Open Source context. tags: ["reading list"] +categories: "documentation" --- diff --git a/content/documentation/text-editors.en.adoc b/content/documentation/text-editors.en.adoc index c3e54fe7..a161e442 100644 --- a/content/documentation/text-editors.en.adoc +++ b/content/documentation/text-editors.en.adoc @@ -3,6 +3,7 @@ title: "Text editors" weight: 50 description: Educational resources, guides, and information about text editors and IDEs. tags: ["tools"] +categories: "documentation" --- diff --git a/content/foss/_index.en.adoc b/content/foss/_index.en.adoc index 33dde0f2..50eebaba 100644 --- a/content/foss/_index.en.adoc +++ b/content/foss/_index.en.adoc @@ -3,5 +3,6 @@ title: "Free & Open Source Software" icon: "ti-world" description: "Build a better understanding of free and open source software." type: "docs" +categories: "foss" --- diff --git a/content/foss/business-sustainability.adoc b/content/foss/business-sustainability.adoc index 86b069c1..807bd766 100644 --- a/content/foss/business-sustainability.adoc +++ b/content/foss/business-sustainability.adoc @@ -3,6 +3,7 @@ title: Business sustainability for Open Source weight: 10 description: Information, best practices, and resources about Open Source business sustainability and business models. tags: ["sustainability"] +categories: "foss" --- :toc: diff --git a/content/foss/contributor-license-agreement-cla.en.adoc b/content/foss/contributor-license-agreement-cla.en.adoc index 0472552e..94dcc805 100644 --- a/content/foss/contributor-license-agreement-cla.en.adoc +++ b/content/foss/contributor-license-agreement-cla.en.adoc @@ -3,6 +3,7 @@ title: "Contributor License Agreements (CLAs)" weight: 20 description: When does your Open Source project need a CLA? What alternatives exist? Cover your copyright in this intro to CLAs. tags: ["legal"] +categories: "foss" --- :toc: diff --git a/content/foss/governance.adoc b/content/foss/governance.adoc index 4b24cebb..6a96be18 100644 --- a/content/foss/governance.adoc +++ b/content/foss/governance.adoc @@ -3,6 +3,7 @@ title: Governance weight: 25 description: Best practices and examples of governance in real Open Source projects. tags: ["policy"] +categories: "foss" --- diff --git a/content/foss/gpl-comparison.en.adoc b/content/foss/gpl-comparison.en.adoc index be0ab309..53cef0b9 100644 --- a/content/foss/gpl-comparison.en.adoc +++ b/content/foss/gpl-comparison.en.adoc @@ -3,6 +3,7 @@ title: "GPLv2 vs. GPLv3" weight: 30 description: A deep dive on the exact differences between the Free Software Foundation's two versions of the GPL license. tags: ["legal"] +categories: "foss" --- *The information shared on this page does not constitute legal or financial advice*. diff --git a/content/foss/reading-list-foss.en.adoc b/content/foss/reading-list-foss.en.adoc index 500a639f..00a8c515 100644 --- a/content/foss/reading-list-foss.en.adoc +++ b/content/foss/reading-list-foss.en.adoc @@ -3,6 +3,7 @@ title: "Reading list: FOSS" weight: 50 description: Various readings and learnings about Free and Open Source Software. tags: ["reading list"] +categories: "foss" --- :toc: diff --git a/content/foss/reading-list-legal.en.adoc b/content/foss/reading-list-legal.en.adoc index a9dd93dd..8c9c964f 100644 --- a/content/foss/reading-list-legal.en.adoc +++ b/content/foss/reading-list-legal.en.adoc @@ -3,6 +3,7 @@ title: "Reading List: Legal & Business Aspects" weight: 60 description: Various readings and learnings about business and legal aspects of Open Source intellectual property. tags: ["reading list"] +categories: "foss" --- :toc: diff --git a/content/foss/reading-list-outreach.en.adoc b/content/foss/reading-list-outreach.en.adoc index fb33c63f..7a5d86b7 100644 --- a/content/foss/reading-list-outreach.en.adoc +++ b/content/foss/reading-list-outreach.en.adoc @@ -3,6 +3,7 @@ title: "Outreach reading list" weight: 70 description: Various readings and learnings about outreach and marketing in an Open Source context. tags: ["reading list"] +categories: "foss" --- diff --git a/content/hardware/case-studies.en.adoc b/content/hardware/case-studies.en.adoc index 5e0fb165..d67657ed 100644 --- a/content/hardware/case-studies.en.adoc +++ b/content/hardware/case-studies.en.adoc @@ -3,6 +3,7 @@ title: Case studies weight: 10 description: Detailed case studies and analysis of different Open Hardware organizations, projects, and products. tags: ["hall of fame"] +categories: "hardware" --- :toc: diff --git a/content/hardware/documentation.en.adoc b/content/hardware/documentation.en.adoc index 93d7781e..9fcf0dcd 100644 --- a/content/hardware/documentation.en.adoc +++ b/content/hardware/documentation.en.adoc @@ -3,6 +3,7 @@ title: Documentation weight: 20 description: How does documentation work for Open Source Hardware? This page provides a brief introduction. tags: ["reading list"] +categories: "hardware" --- diff --git a/content/hardware/intro.en.adoc b/content/hardware/intro.en.adoc index cf5c32d4..1367e7eb 100644 --- a/content/hardware/intro.en.adoc +++ b/content/hardware/intro.en.adoc @@ -3,6 +3,7 @@ title: Introduction to Open Source Hardware weight: 1 description: So, you want to know about Open Source Hardware? Start here to get an introduction to the landscape in the 2020s. tags: ["philosophy"] +categories: "hardware" --- :definition: https://www.oshwa.org/definition/ diff --git a/content/hardware/licensing.en.adoc b/content/hardware/licensing.en.adoc index 43e354f4..d1d5ef85 100644 --- a/content/hardware/licensing.en.adoc +++ b/content/hardware/licensing.en.adoc @@ -3,6 +3,7 @@ title: Licensing weight: 30 description: Information, resources, and details about common licenses used for Open Source Hardware projects. tags: ["legal"] +categories: "hardware" --- :toc: diff --git a/content/hardware/projects.en.adoc b/content/hardware/projects.en.adoc index 1126be56..502445f2 100644 --- a/content/hardware/projects.en.adoc +++ b/content/hardware/projects.en.adoc @@ -3,6 +3,7 @@ title: Project Hall of Fame weight: 50 description: Various Open Source Hardware projects and links back to their projects and/or communities. tags: ["hall of fame"] +categories: "hardware" --- diff --git a/content/hardware/reading-list.en.adoc b/content/hardware/reading-list.en.adoc index 54c7b99b..48b3f438 100644 --- a/content/hardware/reading-list.en.adoc +++ b/content/hardware/reading-list.en.adoc @@ -3,6 +3,7 @@ title: "Open Hardware reading list" weight: 40 description: Various readings and learnings about Open Source Hardware that do not belong on another page. tags: ["reading list"] +categories: "hardware" --- diff --git a/content/meta/modules.en.adoc b/content/meta/modules.en.adoc index 21d7d91f..7564f7bf 100644 --- a/content/meta/modules.en.adoc +++ b/content/meta/modules.en.adoc @@ -3,6 +3,7 @@ title: "Modules" weight: 10 description: Overview of learning modules currently offered through the UNICEF Open Source Mentorship programme. tags: ["docs", "legal", "testing"] +categories: "meta" --- // document settings diff --git a/content/meta/needs-assessment-template.en.adoc b/content/meta/needs-assessment-template.en.adoc index 29845887..e7f15c34 100644 --- a/content/meta/needs-assessment-template.en.adoc +++ b/content/meta/needs-assessment-template.en.adoc @@ -3,6 +3,7 @@ title: "Needs assessment interview template" weight: 50 description: Interview template for UNICEF mentors when meeting a team for the first time. tags: ["tools"] +categories: "meta" --- diff --git a/content/meta/overview.en.adoc b/content/meta/overview.en.adoc index c759f81b..4dd3226c 100644 --- a/content/meta/overview.en.adoc +++ b/content/meta/overview.en.adoc @@ -3,6 +3,7 @@ title: "Open Source Mentorship programme overview" weight: 1 description: An introduction to the UNICEF Open Source Mentorship programme. Hosted by the Office of Innovation. tags: [] +categories: "meta" --- // document settings diff --git a/content/meta/templates.en.adoc b/content/meta/templates.en.adoc index 24b7eb03..ea131d7a 100644 --- a/content/meta/templates.en.adoc +++ b/content/meta/templates.en.adoc @@ -3,6 +3,7 @@ title: "Templates for programme mentors" weight: 60 description: Various templates and reusable copytext for UNICEF Open Source Mentorship programme mentors. tags: ["tools"] +categories: "meta" --- :toc: diff --git a/content/meta/workflow-metrics.en.adoc b/content/meta/workflow-metrics.en.adoc index 3ef6a3a0..863b8670 100644 --- a/content/meta/workflow-metrics.en.adoc +++ b/content/meta/workflow-metrics.en.adoc @@ -3,6 +3,7 @@ title: "Workflow: Update external UNICEF metrics" weight: 70 description: How a UNICEF contractor manages and updates metrics about Innovation Fund portfolio company projects. tags: ["workflows"] +categories: "meta" --- diff --git a/content/meta/workplan-bridge-funding.en.adoc b/content/meta/workplan-bridge-funding.en.adoc index 8c068c72..c28a7190 100644 --- a/content/meta/workplan-bridge-funding.en.adoc +++ b/content/meta/workplan-bridge-funding.en.adoc @@ -3,6 +3,7 @@ title: "Workplan: Bridge Fund cohort" weight: 80 description: Open Source workplan requirements for UNICEF Open Source Mentorship programme. These requirements apply to companies in the Bridge Fund cohort. tags: [] +categories: "meta" --- // document settings diff --git a/content/missions/codes-of-conduct.en.adoc b/content/missions/codes-of-conduct.en.adoc index 1aa4b067..c11cc51f 100644 --- a/content/missions/codes-of-conduct.en.adoc +++ b/content/missions/codes-of-conduct.en.adoc @@ -3,6 +3,7 @@ title: "Codes of Conduct" weight: 10 description: Embark on a mission to add a Code of Conduct to your Open Source community. tags: ["community"] +categories: "missions" --- :page-authors: Justin W. Flory diff --git a/content/missions/good-first-issue.en.adoc b/content/missions/good-first-issue.en.adoc index bf4196ed..51ee65c1 100644 --- a/content/missions/good-first-issue.en.adoc +++ b/content/missions/good-first-issue.en.adoc @@ -3,6 +3,7 @@ title: "Good first issues" weight: 20 description: Embark on a mission to enable new contributors to your Open Source project with Good First Issues (GFIs). tags: ["community"] +categories: "missions" --- diff --git a/content/project-management/issue-templates.en.adoc b/content/project-management/issue-templates.en.adoc index f408612e..82902c0b 100644 --- a/content/project-management/issue-templates.en.adoc +++ b/content/project-management/issue-templates.en.adoc @@ -3,6 +3,7 @@ title: "Issue templates" weight: 10 description: An introduction to issue templates for new Open Source project or community managers. tags: ["community"] +categories: "project-management" --- diff --git a/content/project-management/project-boards.en.adoc b/content/project-management/project-boards.en.adoc index c384881a..ac7c782b 100644 --- a/content/project-management/project-boards.en.adoc +++ b/content/project-management/project-boards.en.adoc @@ -3,6 +3,7 @@ title: "Project boards" weight: 20 description: An introduction to project/kanban boards for new Open Source project or community managers. tags: ["community"] +categories: "project-management" --- diff --git a/content/project-management/reading-list.en.adoc b/content/project-management/reading-list.en.adoc index bb660af1..48fe0230 100644 --- a/content/project-management/reading-list.en.adoc +++ b/content/project-management/reading-list.en.adoc @@ -3,6 +3,7 @@ title: "Community Management Reading List" weight: 30 description: Various readings and learnings about community management in an Open Source context. tags: ["reading list"] +categories: "project-management" --- diff --git a/content/reproducibility/_index.en.adoc b/content/reproducibility/_index.en.adoc index ff104308..4175813d 100644 --- a/content/reproducibility/_index.en.adoc +++ b/content/reproducibility/_index.en.adoc @@ -3,5 +3,6 @@ title: "Reproducibility" icon: "ti-loop" description: "Building and developing reproducible code, science, and data." type: "docs" +categories: "reproducibility" --- diff --git a/content/reproducibility/reading-list.en.adoc b/content/reproducibility/reading-list.en.adoc index c089b50f..ce88bb2a 100644 --- a/content/reproducibility/reading-list.en.adoc +++ b/content/reproducibility/reading-list.en.adoc @@ -3,6 +3,7 @@ title: "Reproducibility reading list" weight: 10 description: Various readings and learnings about reproducibility in an Open Source context. tags: ["reading list"] +categories: "reproducibility" --- From ca4d0698e7bcdf69f8f77b2e451a3d27cf89a4dc Mon Sep 17 00:00:00 2001 From: "Justin W. Flory (he/him) [UNICEF Innovation]" Date: Tue, 10 Aug 2021 18:36:43 +0200 Subject: [PATCH 2/2] config: added taxonomies for related content and limit of displayed related articles --- config.toml | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/config.toml b/config.toml index 1ac0b0fc..27c6159c 100644 --- a/config.toml +++ b/config.toml @@ -116,6 +116,9 @@ font_family = "Open+Sans" # contact form action (works with https://formspree.io) contact_form_action = "#" +# related article number limit +article_count = 3 + ############################# Social links ############################# # themify icon pack : https://themify.me/themify-icons @@ -146,6 +149,11 @@ noClasses = true style = 'murphy' tabWidth = 4 +############################# Related Articles ############################# +[taxonomies] + category = "categories" + + ####################################################################################### # Multilingual configurations # #######################################################################################