Skip to content

Commit 747c981

Browse files
committed
fix pillars
1 parent 2945421 commit 747c981

23 files changed

+129
-40
lines changed

content/en/ai-in-mental-health.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,6 @@ As AI technology [continues to advance](/ai-in-mental-health/harmony-going-forwa
3333

3434
* [Harmony at Lifecourse seminar](/ai-in-mental-health/harmony-at-lifecourse-seminar/) - on 15 May 2024, Eoin McElroy and Bettina Moltrecht gave a seminar Harmony: A global platform for harmonisation, translation and cooperation in mental health research for the Melbourne Children’s LifeCourse Initiative seminar series.
3535
* [Harmony at Methodscon Futures](/ai-in-mental-health/harmony-at-methodscon-futures/) - on 11 and 12 September 2024, Bettina Moltrecht and Thomas Wood presented Harmony at Methodscon Futures in Manchester
36+
* [Harmony and TIDAL workshop](/ai-in-mental-health/harmony-and-tidal-workshop/) - a collaboration with another team on the Wellcome Trust Data Prize for Mental Health
37+
* See other [news coverage](/ai-in-mental-health/news-coverage/).
3638

content/en/blog/combining-multiple-survey-sources.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,10 @@ author: "Vidhya Sudani"
66
categories: ["data"]
77
image: "/images/12- Combining multiple survey sorces - the best practices list.svg"
88

9+
10+
aliases:
11+
- "/combining-multiple-survey-sources-best-practices/"
12+
url: "/data-harmonisation/combine-multiple-survey-sources-best-practices/"
913
---
1014

1115

@@ -126,7 +130,7 @@ Leveraging advanced data integration techniques, such as data fusion and machine
126130

127131
{{< image src="/images/Addressing Challenges.webp" alt="Addressing Challenges" title="Addressing Challenges" >}}
128132

129-
Combining survey sources is fraught with challenges, from differing data quality to incompatible response scales. Addressing these issues head-on is key to successful data harmonisation.
133+
Combining survey sources is fraught with challenges, from differing data quality to incompatible response scales. Addressing these issues head-on is key to [successful data harmonisation](/data-harmonisation/).
130134

131135
## Best Practice 7: Quality Control
132136

content/en/blog/contribute-open-source-project.md

Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ description: Semantic text matching is a task in natural language processing inv
44
date: 2024-01-06
55
categories: ["development"]
66
image: /images/coder.png
7+
8+
aliases:
9+
- "/how-can-i-contribute-to-an-open-source-project/"
10+
url: "/open-source-for-social-science/"
711
---
812

913

@@ -18,13 +22,15 @@ You might find this guide helpful: https://opensource.guide/how-to-contribute as
1822
**1. Start small, think big:**
1923

2024
- Don't feel pressured to tackle the most complex issues right away. Look for smaller tasks that align with your skills and interests.
21-
- These could be fixing typos in documentation, improving code readability, or adding simple features that haven't been prioritised yet.
25+
- These could be fixing typos in documentation, improving code readability, or [adding simple features that haven't been prioritised yet](/open-source-for-social-science/what-features-would-you-like-to-see-in-harmony/).
2226
- Remember, every contribution, no matter how small, adds value to the project.
2327

28+
You can try finding [projects on Kaggle](/open-source-for-social-science/kaggle/) as a place to get started.
29+
2430
**2. Find your niche:**
2531

2632
- Choose a project that aligns with your passions and expertise. This engagement will fuel your motivation and make the learning curve more enjoyable.
27-
- Explore projects you already use and appreciate, or discover new ones that pique your curiosity.
33+
- Explore projects you already use and appreciate, or discover new ones that pique your curiosity.
2834

2935
**3. Embrace the learning curve:**
3036

@@ -35,6 +41,7 @@ You might find this guide helpful: https://opensource.guide/how-to-contribute as
3541
**4. Embrace imperfection:**
3642

3743
- Your first contribution might not be perfect, and that's perfectly OK!
44+
- Even if you struggle to [run the code](/open-source-for-social-science/running-harmony-in-your-browser-with-no-internet-connection/), your feedback on that is helpful as it lets us [troubleshoot the code base](/open-source-for-social-science/troubleshooting-harmony/) for the next joiner.
3845
- The open source community values learning and collaboration. Experienced developers are often happy to provide feedback and guidance to help you improve.
3946
- Be open to constructive criticism and use it as an opportunity to learn and refine your skills.
4047

@@ -43,16 +50,17 @@ You might find this guide helpful: https://opensource.guide/how-to-contribute as
4350
- Every contribution, no matter how small, is a victory. Take pride in your accomplishments and celebrate your progress.
4451
- Each contribution builds your confidence and skills, paving the way for even greater contributions in the future.
4552

46-
**Remember:** Open source communities thrive on diversity and inclusivity. Your unique perspective and skills are valuable, so don't be afraid to share them with the world. Take that first step, start small, and watch your contributions grow alongside your confidence. Together, we can shape the future of open source, one contribution at a time!
53+
**Remember:** Open source communities thrive on diversity and inclusivity. Your unique perspective and skills are valuable, so don't be afraid to share them with the world. Take that first step, start small, and watch your contributions grow alongside your confidence.
4754

4855
## Ideas for open source projects you can contribute to
4956

50-
* **Harmony** - we are always on the lookout for anyone who can work on back end (API), front end, or NLP side of Harmony! https://github.com/harmonydata/harmony
57+
* [Harmony](/open-source-for-social-science/contributing-to-harmony-nlp-project/) - we are always on the lookout for anyone who can work on the back end (API), front end, or NLP side of Harmony! https://github.com/harmonydata/harmony
5158
* [spaCy](https://github.com/explosion/spaCy) - one of the best known NLP libraries
5259
* [Country Named Entity Recognition](https://github.com/fastdatascience/country_named_entity_recognition) - a lightweight Python library for recognising country names in unstructured text and returning Pycountry objects. Very simple and a good library to start with on your open source journey `pip install country_named_entity_recognition`
5360
* [Drug Named Entity Recognition](https://github.com/fastdatascience/drug_named_entity_recognition) - a lightweight Python library for recognising drug names in unstructured text `pip install drug-named-entity-recognition`
5461
* [Fast Stylometry](https://github.com/fastdatascience/faststylometry) - a Python library for identifying the author of an unknown text (forensic stylometry). `pip install faststylometry`. [Read tutorial](https://fastdatascience.com/fast-stylometry-python-library/).
5562

63+
5664
## How can I contribute to Harmony?
5765

5866
Read our [guide to contributing to Harmony](/contributing-to-harmony/).
@@ -64,7 +72,7 @@ Harmony is a powerful [data harmonisation tool](/data-harmonisation/) which uses
6472
Harmony's back end is built in Python and the front end is in React. There is also an [R library](/harmony-r-notebook-r-markdown-example/). Whether you're a seasoned developer or a coding newbie, there's a place for you. You can:
6573

6674
* [Browse open issues and pull requests](https://github.com/harmonydata/harmony/issues) and find a challenge that sparks your interest and contribute your unique skills.
67-
* **Help maintain the existing code:** Fix bugs, improve documentation, and suggest optimizations.
75+
* **Help maintain the existing code:** [Fix bugs](/open-source-for-social-science/harmony-update-new-features-and-bug-fixes/), improve documentation, and suggest optimisations.
6876
* **Develop new features:** Take Harmony to the next level by proposing and implementing innovative solutions.
6977

7078
### 2. Work on the NLP models
@@ -79,12 +87,17 @@ The deeper we understand language, the better we can harmonise the world's resea
7987

8088
### 3. Publicise Harmony
8189

82-
Harmony's mission thrives on awareness and accessibility. You can be a champion for open data by:
90+
Harmony's mission thrives on awareness and accessibility. Can you [champion the Harmony project online](/open-source-for-social-science/marketing-for-open-science/)?
8391

8492
* **Writing blog posts and articles:** Share your experiences with Harmony and inspire others to join the cause.
8593
* **Creating tutorials and videos:** Make Harmony approachable for beginners and showcase its potential to a wider audience.
8694
* **Promoting Harmony as an open source project on social media:** Share the love on Twitter, Facebook, and beyond, using the hashtag #OpenSourceHarmony.
95+
* **Join Harmony's public events** - we have run a [hackathon](/open-source-for-social-science/hackathon/), an [online orientation session](/open-source-for-social-science/harmony-orientation-session/) and been active in [Pydata](/open-source-for-social-science/pydata-meetup/), [AI Camp](/psychology-ai-tool/aicamp-meetup/) and other events.
8796

88-
**Ready to join the Harmony open source project?** Head over to our GitHub repository at [https://github.com/harmonydata/harmony](https://github.com/harmonydata/harmony), explore the free web tool at [harmonydata.ac.uk/app](https://harmonydata.ac.uk/app), and dive into our documentation. We're waiting for you with open arms (and open-source code)!
97+
**Ready to join the Harmony open source project?** Head over to our GitHub repository at [https://github.com/harmonydata/harmony](https://github.com/harmonydata/harmony), explore the free web tool at [harmonydata.ac.uk/app](https://harmonydata.ac.uk/app), and dive into our documentation.
98+
99+
You can also try working on the [Harmony R package](/open-source-for-social-science/harmony-r-package/) on [CRAN](/open-source-for-social-science/harmony-cran/) or try extending the [Harmony API](/open-source-for-social-science/harmony-api/).
89100

90101
**Bonus tip:** We also have a [Docker container](https://hub.docker.com/r/harmonydata/harmonyapi) available, making it even easier to get started with Harmony. Just check out our documentation for more details.
102+
103+
Together, we can shape the future of Harmony as an open source project and make it [more sustainable](/open-source-for-social-science/sustainability/) for the future.

content/en/blog/contributing.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ description: Want to help develop Harmony?
44
date: 2023-12-22
55
categories: ["development"]
66
image: /images/join-open-source-project.png
7+
8+
9+
aliases:
10+
- "/contributing-to-harmony/"
11+
url: "/open-source-for-social-science/contributing-to-harmony-nlp-project/"
712
---
813

914
## Contribute to the Harmony open source NLP project

content/en/blog/data-harmonisation.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ In summary, data harmonisation brings about significant improvements in the qual
8787

8888
7. **Diverse Data Sources**: Integrating data from diverse sources adds complexity due to varying formats, standards, and quality. Each source may have its unique characteristics and challenges that need to be addressed in the harmonisation process.
8989

90-
8. **Data Quality Concerns**: Ensuring the accuracy, consistency, and reliability of the harmonised data is crucial. This involves identifying and correcting errors in the data, which can be a significant hurdle, especially when dealing with large volumes of data from multiple sources.
90+
8. **Data Quality Concerns**: Ensuring the accuracy, consistency, and reliability of the harmonised data is crucial. This involves identifying and correcting errors in the data, which can be a significant hurdle, especially when dealing with [large volumes of data from multiple sources](/data-harmonisation/combine-multiple-survey-sources-best-practices/).
9191

9292
Each of these challenges represents a significant aspect of the data harmonisation process, requiring careful planning, skilled resources, and often sophisticated technological solutions to overcome.
9393

@@ -118,10 +118,11 @@ Let's explore this need further in various sectors:
118118

119119
9. **Telecommunications**: Telecom companies use data harmonisation to integrate customer data, usage patterns, and network data from various sources. This helps in improving network efficiency, customer service, and in developing new services.
120120

121-
These examples demonstrate the vast applicability and critical importance of data harmonisation in extracting meaningful insights, making informed decisions, and enhancing operational efficiency across different sectors.
121+
These examples demonstrate the vast applicability and critical importance of data harmonisation in [extracting meaningful insights](/data-harmonisation/extract-process-data-from-questionnaires/), making informed decisions, and enhancing operational efficiency across different sectors.
122122

123123

124124
## Data Harmonisation in Practice
125+
125126
Data harmonisation is not a theoretical concept but a practical necessity across various sectors. For instance, in healthcare, harmonising patient data from different hospitals leads to better patient care and research outcomes. In [marketing](/data-harmonisation/data-harmonisation-for-marketing-success-strategies-and-insights/), it helps in understanding consumer behavior by integrating data from diverse sources.
126127

127128
**[Harmony: A Specialised Tool for Data Harmonisation](https://harmonydata.ac.uk/)**

content/en/blog/extract-process-data.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,9 @@ Let's go through these strategies together. Get ready to turn challenges into ch
2323

2424
Pulling [data from questionnaires](/data-harmonisation/find-matching-and-common-items-in-questionnaires-and-surveys/) is an important step in transforming the gathered responses into actionable insights. This involves handling both structured and unstructured data.
2525

26-
What’s the difference, you ask? Structured data is the kind that fits neatly into categories, such as the choices selected in a multiple-choice question. On the flip side, unstructured data includes the free-text responses where participants express their thoughts in their own words.
26+
### Structured vs unstructured data
27+
28+
Structured data is the kind that fits neatly into categories, such as the choices selected in a multiple-choice question. On the flip side, unstructured data includes the free-text responses where participants express their thoughts in their own words.
2729

2830
Data can be collected in several ways – these ways each reflect the unique methods by which questionnaires are shared and completed. For instance, paper forms are a classic approach that requires participants to mark their answers physically. These responses then need to be manually keyed into a digital system for analysis – a process that might take a bit of elbow grease but is key for some research types.
2931

@@ -59,7 +61,7 @@ Why bother with all this? Well, just like you wouldn't want to base your decisio
5961

6062
Seems like a lot of work? A customised method can greatly ease and improve the process. This is where we want to tell you about our favourite (and very own) tool: Harmony.
6163

62-
Harmony revolutionises the way we approach the complex task of harmonising questionnaire data. With its advanced Natural Language Processing (NLP) at the core, Harmony offers a tailored solution that excels in interpreting, comparing, and integrating data across languages and formats, making it invaluable for international research and projects with diverse data sources.
64+
Harmony revolutionises the way we approach the complex task of [harmonising questionnaire data](/data-harmonisation/). With its advanced Natural Language Processing (NLP) at the core, Harmony offers a tailored solution that excels in interpreting, comparing, and integrating data across languages and formats, making it invaluable for international research and projects with diverse data sources.
6365

6466
### Main features of Harmony
6567

content/en/blog/file-formatting-guidance.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@ description: How to fix problems in Harmony
44
date: 2023-12-07
55
categories: ["users"]
66
image: /images/formatting-min.jpg
7+
8+
aliases:
9+
- "/formatting-help/"
10+
url: "/open-source-for-social-science/formatting-help/"
711
---
812

913
# How should I format my file for Harmony?
@@ -20,3 +24,5 @@ If you want to upload multiple questionnaires in a single file, you can use Exce
2024
In all cases we recommend clearly supplying question numbers, question texts, and removing extraneous information such as copyright disclaimers for best results.
2125

2226
If you are having trouble parsing a document in Harmony, you can [raise an issue](https://github.com/harmonydata/harmony/issues) or [try our troubleshooting tips](/troubleshooting-harmony).
27+
28+
Harmony is an [open source tool for social science research](/open-source-for-social-science/).

content/en/blog/hackathon.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,10 @@ title: "Harmony Hackathon on 3 June"
33
date: 2024-04-22
44
categories: ["development"]
55
image: "/images/Hackathon Banner.png"
6-
url: "/hackathon"
6+
7+
aliases:
8+
- "/hackathon/"
9+
url: "/open-source-for-social-science/hackathon/"
710
---
811

912
## The Harmony Hackathon
@@ -88,3 +91,6 @@ What you have achieved; key outputs; next steps
8891
{{< youtube Okk8tUMDr6g >}}
8992

9093
*Video tutorial on how to install Harmony Python library*
94+
95+
96+
Harmony is an [open source tool for social science research](/open-source-for-social-science/).

content/en/blog/harmony-cran.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,15 @@ description: Semantic text matching is a task in natural language processing inv
44
date: 2023-09-06
55
categories: ["development"]
66
image: "https://raw.githubusercontent.com/harmonydata/.github/main/profile/harmony_cran.gif"
7-
aliases: "/blog/harmony-cran"
7+
8+
aliases:
9+
- "/blog/harmony-cran/"
10+
- "/harmony-cran/"
11+
url: "/open-source-for-social-science/harmony-cran/"
812
---
913

1014

11-
We are excited to announce that Harmony, a Natural Language Processing tool for data harmonisation, is now available on the Comprehensive R Archive Network [CRAN](https://cran.r-project.org/)!
15+
We are excited to announce that Harmony, an [open source](/open-source-for-social-science/) Natural Language Processing tool for data harmonisation, is now available on the Comprehensive R Archive Network [CRAN](https://cran.r-project.org/)!
1216

1317
Previously, [Harmony R](/harmony-r-released/) could be installed using [devtools](https://www.r-project.org/nosvn/pandoc/devtools.html).
1418

content/en/blog/harmony-r.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,13 @@ description: You can run Harmony in R
44
date: 2023-08-21
55
categories: ["development"]
66
image: /images/r.png
7+
8+
aliases:
9+
- "/harmony-r-released/"
10+
url: "/open-source-for-social-science/harmony-r-package/"
711
---
812

9-
We have developed the R package for Harmony. To get started, you need R installed on your system.
13+
We have developed the R package for Harmony and [open sourced](/open-source-for-social-science/) it. To get started, you need R installed on your system.
1014

1115
[Click here](https://colab.research.google.com/github/harmonydata/experiments/blob/main/Harmony_R_example.ipynb) to try an example in Google Colab.
1216

0 commit comments

Comments
 (0)