Skip to content

Commit

Permalink
Merge pull request #303 from OpenRefine/website_restructure
Browse files Browse the repository at this point in the history
#291 update header and footer, update community page, add ecosystem, usage and history page
  • Loading branch information
magdmartin committed Apr 29, 2024
2 parents 0a0f41a + 5f1c4a8 commit cdde818
Show file tree
Hide file tree
Showing 17 changed files with 223 additions and 31 deletions.
50 changes: 36 additions & 14 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,12 @@ module.exports = {
position: 'right',
},
{
href: 'https://github.com/OpenRefine/OpenRefine',
to: 'https://forum.openrefine.org/',
label: 'Forum',
position: 'right',
},
{
href: 'https://github.com/OpenRefine/',
label: 'GitHub',
position: 'right',
},
Expand Down Expand Up @@ -89,8 +94,8 @@ module.exports = {
href: '/distributions',
},
{
label: 'GitHub repository',
href: 'https://github.com/OpenRefine/OpenRefine',
label: 'Ecosystem',
href: '/ecosystem',
},
],
},
Expand All @@ -101,30 +106,47 @@ module.exports = {
label: 'User manual',
href: '/docs',
},
{
label: 'Training and Courses',
href: '/external_resources',
},
{
label: 'Contributing',
href: '/docs/technical-reference/contributing',
},
{
label: 'Privacy notice',
href: '/privacy',
},
],
},
{
title: 'About OpenRefine',
items: [
{
label: 'Project history',
href: '/openrefine_history',
},
{
label: 'External resources',
href: '/external_resources',
label: 'Project Roles and Governance',
href: '/community',
},
{
label: 'Grants & funding',
href: '/funding',
label: 'Who uses OpenRefine',
href: '/usage',
},
{
label: 'Privacy notice',
href: '/privacy',
},
label: 'Grants & funding',
href: '/funding',
},
],
},
{
title: 'Community',
title: 'Social',
items: [
{
label: 'Get involved',
href: '/community',
label: 'GitHub',
href: 'https://github.com/OpenRefine',
},
{
label: 'Forum',
Expand All @@ -146,7 +168,7 @@ module.exports = {
],
},
],
copyright: `<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/80x15.png" /></a><br />OpenRefine's documentation is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.`,
copyright: `<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"><img alt="Creative Commons License" style="border-width:0" src="https://i.creativecommons.org/l/by/4.0/80x15.png" /></a><br />OpenRefine's website and documentation is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.`,
},
},
plugins: ['./src/plugins/docusaurus-versionsjson-plugin'],
Expand Down
41 changes: 26 additions & 15 deletions src/pages/community.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,37 +4,48 @@ description: Join our community of users, trainers and contributors around the w
hide_table_of_contents: true
---

<!-- Add mission, vision and value here once they are clarified -->

# Get involved in the OpenRefine community

Join our vibrant community of users and contributors on these platforms.
OpenRefine is made by people like you. You can help us in many ways, including the roles below.


import OpenRefineIsMagicImageUrl from '@site/static/img/openrefine_is_magic.png';


import Card from '../card.tsx';

<div className="cardList">
<Card href="https://forum.openrefine.org" title="Forum" description="Ask for support, share your ideas and join the team." />
<Card href="https://github.com/OpenRefine/OpenRefine" title="GitHub project" description="Contribute and coordinate improvements to the tool." />
<Card href="/docs/technical-reference/code-contributions" title="Developer" description="to maintain OpenRefine or develop a new extensions"/>
<Card href="/docs/technical-reference/introduction" title="Designer" description="to improve OpenRefine usability" />
</div>
<div className="cardList">
<Card href="https://hosted.weblate.org/engage/openrefine/" title="Translate OpenRefine" description="Contribute translations of the interface in your language via Weblate." />
<Card title="Social media" description="Share your thoughts with the #openrefine tag on your favourite social media platform." />
<Card href="/docs/technical-reference/documentation-contributions" title="Technical Writer" description="to keep our user documentation up to date and enrich it with more example" />
<Card href="https://hosted.weblate.org/engage/openrefine/" title="Translator" description="to translate OpenRefine interface in your language via Weblate." />
</div>
<div className="cardList">
<Card href="https://forum.openrefine.org/c/support/12" title="OpenRefine expert" description="by answering OpenRefine-related questions in your community preferred channels (Slack, Telegram, or other form of discussion list), by monitoring social media or our forum. Help us by turn recurring bug report and feature requests and bug reports GitHub issues" />
<Card title="Advocate & Trainer" description="by introducing OpenRefine to your community and by providing customed training based on your community workflow and dataset" />
</div>

<br />

## We need your help!

import OpenRefineIsMagicImageUrl from '@site/static/img/openrefine_is_magic.png';
<!-- TODO rebuild the structure of the URL for each contributor guide. Add placeholder for the new one -->

<div style={{float: 'right', textAlign: 'right'}}>
<img src={OpenRefineIsMagicImageUrl} alt="OpenRefine is magic" id="magic"/>
<p style={{fontSize: '0.7em'}}><a href="https://commons.wikimedia.org/wiki/File:Open_Refine_is_Magic.png">CC-BY-SA Scott Carlson</a></p>
</div>
# Connect with us

Join our vibrant community of users and contributors. We listed below the platforms used by the core team, however a lot of great conversation happen directly within our user community preferred channel.

OpenRefine is made by people like you. You can help by:

- helping out with user support, for instance on the platforms listed above;
- developing training material and running workshops to introduce new users to the tool;
- contributing translations on [Weblate](https://hosted.weblate.org/engage/openrefine/);
- [improving OpenRefine's official documentation](/docs/technical-reference/contributing#contributing-to-the-documentation);
- [getting involved in the development of the tool](https://github.com/OpenRefine/OpenRefine/blob/master/CONTRIBUTING.md);
- [donating to OpenRefine](/donate).
| Platform | Come here for |
| --------------- | --------------- |
| **GitHub** <br></br> <img src="/img/logo/github.png" alt="github" height="95"/>|GitHub is where OpenRefine code live. We maintain two main repositories: <br></br> <li> **[OpenRefine](https://github.com/OpenRefine/OpenRefine)** where you can contribute to OpenRefine development and translation. This is also the place to [file a bug or feature request](https://github.com/OpenRefine/OpenRefine/issues/new/choose)</li> <li> **[openrefine.org](https://github.com/OpenRefine/openrefine.org)** is where we maintain our documentation and this website.</li> |
| **Forum** <br></br> <img src="/img/logo/discourse.png" alt="discourse" height="95"/>|After GitHub this is our main communication platform. Join our forum to ask for [support](https://forum.openrefine.org/c/support/12) when using OpenRefine, discuss [OpenRefine development](https://forum.openrefine.org/c/dev/8) and check the latest [community update](https://forum.openrefine.org/c/news/13).<p></p> You can find here our archived [user](https://groups.google.com/u/2/g/openrefine) and [development](https://groups.google.com/u/2/g/openrefine-dev) mailing list.|
| **Community Calls** <br></br> <img src="/img/logo/gh-og.png" alt="greenhost" height="95"/>| We are organizing [bi-weekly video call](https://forum.openrefine.org/t/openrefine-community-meetup/1276) where everybody is welcome to chat about OpenRefine, ask questions, share things they do with OpenRefine. It happens every two weeks on alternating times: 07:00 UTC on Friday and 15:00 UTC on Tuesday. |
| **Chat** <br></br> <img src="/img/logo/gitter.png" alt="gitter" height="95"/>|You can join us on [gitter chat](https://app.gitter.im/#/room/#OpenRefine_OpenRefine:gitter.im) for real time chat. The room is not always monitored and we invite you to post on our forum if you do not receive an answer.|
| **Social Media** <br></br> <img src="/img/logo/x.svg" alt="x" height="35"/> <img src="/img/logo/LinkedIn.png" alt="LinkedIn" height="35"/> <img src="/img/logo/Mastodon.png" alt="Mastodon" height="35"/> | We share project announcements, opportunities, upcoming events, on diverse social media platforms. Follow and tag #OpenRefine on [LinkedIn](https://www.linkedin.com/company/openrefine/), [Twitter/X](https://twitter.com/openrefine) or [Mastodon]( https://fosstodon.org/@OpenRefine).|
7 changes: 5 additions & 2 deletions src/pages/donate.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,11 @@ hide_table_of_contents: true

Your donations help further maintain and further develop OpenRefine. Thank you for your support!

<script src="https://donorbox.org/widget.js" paypalExpress="true"></script><iframe src="https://donorbox.org/embed/open-refine" name="donorbox" allowpaymentrequest="allowpaymentrequest" seamless="seamless" frameborder="0" scrolling="yes" width="100%" style={{maxWidth: '500px', minWidth: '250px', minHeight: '750px', maxHeight: 'none!important'}}></iframe>

OpenRefine is a fiscally sponsored project of [Code for Science & Society Inc.](https://codeforscience.org). Donations are tax deductible to the extent allowed by law in the US. Tax ID 81-3791683.

You can also support OpenRefine via <a href="https://github.com/sponsors/OpenRefine">GitHub Sponsors</a>.
<script src="https://donorbox.org/widget.js" paypalExpress="true"></script><iframe src="https://donorbox.org/embed/open-refine" name="donorbox" allowpaymentrequest="allowpaymentrequest" seamless="seamless" frameborder="0" scrolling="yes" width="100%" style={{maxWidth: '500px', minWidth: '250px', minHeight: '750px', maxHeight: 'none!important'}}></iframe>




14 changes: 14 additions & 0 deletions src/pages/ecosystem.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: OpenRefine Ecosystem
description: OpenRefine Ecosystem
hide_table_of_contents: true
---
# OpenRefine Ecosystem

The OpenRefine ecosystem comprises the OpenRefine project, which maintains the [OpenRefine software](https://github.com/OpenRefine/openrefine), [user forums](https://forum.openrefine.org/), [documentation](/docs) and [translation](/docs/technical-reference/translating-ui), and user groups that contextualize OpenRefine for their communities' usage.

Those user groups include data journalists, semantic web enthusiasts, Galleries, Libraries, Archives, Museums (GLAM), researchers, or members of the Wikimedia Movement. Each community provides advocacy, training, and support activities via mediums relevant to its members, with little coordination between them. For instance, libraries host training sessions for archivists, librarians, and researchers; workshops are organized during data journalism conferences; and a dedicated Telegram channel is available for Wikimedians seeking support.

Third-party developers create [extensions](/extensions) and [reconciliation services](/extensions#reconciliation-services) compatible with OpenRefine. Reconciliation services allow users to link their datasets with a external data sources, while extensions add domain-specific features or integrate OpenRefine into a particular workflow. These services expand OpenRefine's capabilities, enabling users to accomplish their tasks more efficiently.

Finally, the Advisory Committee is responsible for OpenRefine funding and administrative tasks to support the ecosystem. It coordinates with [Code for Science and Society](https://www.codeforsociety.org/), our fiscal host, and OpenRefine [funders](/funding).
60 changes: 60 additions & 0 deletions src/pages/openrefine_history.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: OpenRefine Project History
description: A brief overview of OpenRefine History
hide_table_of_contents: false
---
# OpenRefine History

Over the last ten years, OpenRefine has undergone significant transformations, including changes in its name and development model. It has transitioned from an enterprise-led open source model to a community-based open source model, with later support from occasional grants.

```mermaid
%%{init: { 'theme': 'forest', 'timeline': {'disableMulticolor': true}}}%%
timeline
title OpenRefine timeline
. : Project Name
: Main Release
: Development Model
2008 - 2010 : Freebase Gridworks
: Version 1.0
: Lead by Metaweb Technologies, Inc. with open source contributors
2010 - 2012 : Google Refine
: Version 2.0 and 2.5
: Lead by Google with open source contributors
2012 - 2018 : OpenRefine
: Version 2.6
: Solely with volunteer open source contributors
2018 - 2019 : OpenRefine
: Version 3.0
: First grants with Google News Initiatives and CZI with open source contributors
2020 - Today : OpenRefine
: Version 3.3+
: Grant based model with CS&S as fiscal sponsor with open source contributors
```

## 2008 - 2010: Freebase Gridworks
<img src="/img/logo/freebase.png" alt="Freebase Gridworks" height="50"/>
The history of OpenRefine dates back to May 2010, when Metaweb Technologies, Inc. initiated the development of an open-source data cleansing tool named Freebase Gridworks. Freebase Gridworks, conceived by David Huynh, simplified data cleaning and transformation data to import into Freebase, a large collaborative knowledge base built by Metaweb. Freebase Gridworks offered a user interface for editing and reconciling large datasets.

## 2010 - 2012: Google Refine
<img src="/img/logo/google-refine.png" alt="Google Refine" height="50"/>
In July 2010, Google acquired Metaweb Technologies and with it, Freebase Gridworks. Following this acquisition, the tool was renamed "Google Refine". Under Google's stewardship, Google Refine 2.0 was released, featuring enhanced data cleaning capabilities. This version established the tool's reputation for handling various data-related tasks, such as cleaning messy data, transforming data formats, and extending data sets with web services.

## 2012 - 2019: OpenRefine
<img src="/img/logo/open-refine.png" alt="OpenRefine" height="50"/>
In 2012, Google transferred leadership of the project to the open source community, who renamed it "OpenRefine" and moved it to GitHub. The following years saw OpenRefine continuing to gain a diverse user base, including scientists and researchers, journalists, semantic web practitioners, librarians, and cultural heritage specialists.

In 2017, OpenRefine began integrating with Wikidata thanks to the availability of a reconciliation endpoint and a process to publish data to the Wikimedia project.

In December 2018, Google News Initiative donated $100,000 to support OpenRefine development. The same year the project's logo was updated.

## 2019 - today: OpenRefine, part of Code for Science & Society
<img src="/img/logo/OpenRefine.png" alt="OpenRefine" height="50"/>

In the following years, OpenRefine confirmed its grant-based sustainability model by receiving recurring funding from the Chang Zuckerberg Initiative, the Wikimedia Foundation, and NFDI. To help manage funds, OpenRefine became a fiscally sponsored project of Code for Science and Society (CS&S), a 501(c)(3) charitable organization in the USA, in 2020.

During that time, OpenRefine experienced tremendous growth by doubling the number of active contributors (both paid and volunteers), increasing the number of translated languages, adding native integration with Wikimedia Commons and Wikibase, and seeing more users rely on it. The project also became more organized with the creation of an Advisory Committee and participation in internship programs like Google Summer of Code and Outreachy.

0 comments on commit cdde818

Please sign in to comment.