Skip to content

Commit

Permalink
📝 faq: Add questions (closes #35)
Browse files Browse the repository at this point in the history
This commit reworks the Frequently Asked Questions (F.A.Q.) page on the
site to include more useful information about the UNICEF Open Source
Inventory, how it is maintained, who is responsible for it, how to
contribute, and more.

This also changes the file from an AsciiDoc to Markdown file because the
content inside of the FAQ shortcodes must be Markdown in order to
render. Therefore, it does not make sense to keep the file as AsciiDoc
when all the contents of the file are written in Markdown.

Closes #35.
Closes unicef/inventory-hugo-theme#162.

Signed-off-by: Justin W. Flory (he/him) [UNICEF Innovation] <[email protected]>
  • Loading branch information
jwflory committed Oct 7, 2022
1 parent c708b9c commit 95b0dbf
Show file tree
Hide file tree
Showing 2 changed files with 141 additions and 32 deletions.
32 changes: 0 additions & 32 deletions content/faq/_index.en.adoc

This file was deleted.

141 changes: 141 additions & 0 deletions content/faq/_index.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
---
title: "Frequently Asked Questions"

---

{{< faq "Why does the UNICEF Open Source Inventory exist?" >}}
The UNICEF Open Source Inventory was originally created in July 2019 as a mentoring tool for UNICEF Venture Fund startup companies.
The website is a living collection of information about best practices for working in Free & Open Source products, projects, and communities.
It was created to help collect answers to questions brought by the startup companies as they set out to build a business model around their Open Source intellectual property.
Today, its scope expands with a focus on achieving the compliance of a digital solution with the [Digital Public Goods Standard](https://digitalpublicgoods.net/standard/).
Additionally, an ongoing collection of knowledge reduces the on-boarding burden for new mentors who join the UNICEF Venture Fund.

However, this information is not only useful to UNICEF Venture Fund startup companies.
Several articles in this site feature contributions from external authors.
So, this site is created and shared in an Open Source format in order to build a community of practice around best practices.
{{< /faq >}}


{{< faq "What is the UNICEF Venture Fund?" >}}
The [UNICEF Venture Fund](https://www.unicefinnovationfund.org/) invests in early stage, Open Source, emerging technology digital public goods with the potential to impact children on a global scale.
It also provides product and technology assistance, support with business growth, and [access to a network of experts and partners](https://www.unicef.org/innovation/stories/spurring-new-digital-public-goods) to allow for scale and growth.
Our ambition is to build successful digital solutions into Global [Digital Public Goods](https://digitalpublicgoods.net/digital-public-goods/), to ensure fair, equitable, and open access to these unique and new tools for human development on a global scale.

The UNICEF Venture Fund is the first financial vehicle of its kind in the United Nations and enables UNICEF to learn from and to shape markets of emerging technology that exist at the intersection of $100 billion business markets and 1 billion persons’ needs.
Founded in 2016, the core motivation of the Venture Fund is to identify "clusters" or portfolios of initiatives around emerging technology - so that UNICEF can both shape markets and also learn about and guide these technologies to benefit children.
We invest in digital public goods that can impact the lives of vulnerable populations.
{{< /faq >}}


{{< faq "What are Digital Public Goods?" >}}
[Digital public goods](https://en.wikipedia.org/wiki/Digital_public_goods) are Open Source software, open data, open AI models, open standards, and open content that adhere to privacy and other applicable laws and best practices, do no harm by design, and help attain the Sustainable Development Goals (SDGs).
This definition is operationalised through the DPG Standard, a set of nine indicators that is used to determine whether a solution is a digital public good.
Once a solution is recognised as a digital public good, it is discoverable on the DPG Registry.

Open Source refers to something, historically software, that people can modify, share and re-use because its design or “source code” is made publicly accessible.
Open Source products provide universal access through an Open Source license that legally enables it.
In order for something to be recognised as a digital public good, solutions must demonstrate use of an approved Open Source license.
{{< /faq >}}


{{< faq "Who maintains the UNICEF Open Source Inventory?" >}}
Any full-time or part-time Open Source Technical Advisors to the UNICEF Venture Fund.
These are typically SSA roles in the [UNICEF Office of Innovation](https://www.unicef.org/innovation/), Ventures Team reporting to OOI HQ in Stockholm, Sweden.
Other Ventures Team members also building Open Source Software may participate in periodic maintenance and stewardship.
{{< /faq >}}


{{< faq "What information can I find on the UNICEF Open Source Inventory?" >}}
This website is divided into five top-level categories:

1. [**DPG Standard indicators**]({{< ref "dpg-indicators" >}}):
Detailed information and guidance on the indicators of the DPG Standard and how to achieve them in an Open Source work.
1. [**UNICEF Venture Fund Cohorts**]({{< ref "cohorts" >}}):
Explore UNICEF Venture Fund start-up companies and Open Source projects by cohort.
1. [**UNICEF Mentorship**]({{< ref "mentoring" >}}):
Information about the Open Source Technical Assistance mentoring programme offered by the UNICEF Venture Fund.
1. [**Toolkits**]({{< ref "toolkits" >}}):
Toolkits for other UNICEF Technical Assistance programmes. You will be redirected to another UNICEF Toolkit site when choosing another toolkit.
1. [**Site maintenance**]({{< ref "meta" >}}):
Documentation and reference material about this website, the UNICEF Open Source Inventory.

You can browse these categories by section, or use the [search bar]({{< ref "/" >}}) on the home page to look for specific content.
{{< /faq >}}


{{< faq "How can I contribute to the UNICEF Open Source Inventory?" >}}
See the [CONTRIBUTING.md](https://github.com/unicef/inventory/blob/main/.github/CONTRIBUTING.md) on GitHub.

We can currently accept three types of contributions:

* **Content**:
Propose new ideas for content around the Digital Public Goods indicators.
Share feedback and improvements to existing content.
Comment as a reviewer on new content proposals.
* **Design**:
Conduct a design review of the UNICEF Open Source Inventory or its parent, the [UNICEF Inventory theme](https://unicef.github.io/inventory-hugo-theme/).
Run user testing interviews and share report-backs and suggestions.
* **Software**:
Contribute to the Hugo theme used for this site and other UNICEF Mentor Toolkits, the [UNICEF Inventory theme](https://github.com/unicef/inventory-hugo-theme).
Review the GitHub Issues tracker for ["help wanted" issues](https://github.com/unicef/inventory-hugo-theme/issues?q=is%3Aissue+is%3Aopen+label%3A%22I%3A+help+wanted%22).
Support best practices for building and deploying a Hugo website to GitHub Pages.

Currently, we use GitHub Issues as the primary way to discuss new ideas and plan work.
See the [CONTRIBUTING.md](https://github.com/unicef/inventory/blob/main/.github/CONTRIBUTING.md) for more guidance with participating on GitHub.
{{< /faq >}}


{{< faq "How do I create a new UNICEF Mentor Toolkit like this site?" >}}
See the [UNICEF Inventory theme website](https://unicef.github.io/inventory-hugo-theme), on [_Create a new UNICEF Toolkit_](https://unicef.github.io/inventory-hugo-theme/install/unicef-toolkit/).
{{< /faq >}}


{{< faq "What Open Source licenses are recognized by the UNICEF Venture Fund?" >}}
The UNICEF Venture Fund shares the same list of recognized licenses as the Digital Public Goods Alliance.
For software, these are only licenses certified by the [Open Source Initiative](https://opensource.org/about) as compliant to the [Open Source Definition](https://opensource.org/osd-annotated).
See the [full list of recognized licenses](https://github.com/DPGAlliance/publicgoods-candidates/blob/main/help-center/licenses.md) on GitHub.
{{< /faq >}}


{{< faq "What are DPG indicators?" >}}
Digital Public Good (DPG) indicators are nine indicators and requirements comprising the [DPG Standard](https://digitalpublicgoods.net/standard/).
These indicators determine whether nominated software, data, AI models, standards and/or content can be considered a DPG.
{{< /faq >}}


{{< faq "What are Venture Fund cohorts?" >}}
Venture Fund cohorts refer to thematic cohorts of startup companies receiving capital investment by the UNICEF Venture Fund.
During the investment round, the startup companies are matched to mentors across a range of industry-relevant topic areas, including an Open Source mentor.
This website supports the curation of Venture Fund portfolio companies in their progress towards achieving compliance with the DPG Standard and its indicators.
<!-- #TODO: Link here to a feature doc page about the Team Profiles feature in the UNICEF Inventory theme. -->
{{< /faq >}}


{{< faq "How is content on the UNICEF Open Source Inventory licensed?" >}}
This website is primarily content and it is licensed under a [Creative Commons Attribution ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/).
This is a human-readable summary of (and not a substitute for) the license.

You are free to:

* **Share**:
Copy and redistribute the material in any medium or format
* **Adapt**:
Remix, transform, and build upon the material for any purpose, even commercially

Provided you meet the following terms:

* **Attribution**:
You must give appropriate credit, provide a link to the license, and indicate if changes were made.
You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
* **Share-Alike**:
If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.
* **No additional restrictions**:
You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
{{< /faq >}}


{{< faq "Is the UNICEF Open Source Inventory in a public repository?" >}}
Yes.
You can find it on GitHub.
[github.com/unicef/inventory](https://github.com/unicef/inventory)
{{< /faq >}}

0 comments on commit 95b0dbf

Please sign in to comment.