Skip to content

Commit 9a40b90

Browse files
committed
initial commit
0 parents  commit 9a40b90

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

65 files changed

+2681
-0
lines changed

.github/workflows/docs.yml

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# Basic ODK workflow
2+
name: Docs
3+
4+
# Controls when the action will run.
5+
on:
6+
# Allows you to run this workflow manually from the Actions tab
7+
workflow_dispatch:
8+
push:
9+
branches:
10+
- main
11+
12+
# A workflow run is made up of one or more jobs that can run sequentially or in parallel
13+
jobs:
14+
build:
15+
name: Deploy docs
16+
runs-on: ubuntu-latest
17+
steps:
18+
- name: Checkout main
19+
uses: actions/checkout@v4
20+
21+
- name: Deploy docs
22+
uses: mhausenblas/mkdocs-deploy-gh-pages@master
23+
# Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
24+
env:
25+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
26+
CONFIG_FILE: mkdocs.yaml
27+

.github/workflows/qc.yml

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# Basic ODK workflow
2+
3+
name: CI
4+
5+
# Controls when the action will run.
6+
on:
7+
# Triggers the workflow on push or pull request events but only for the main branch
8+
push:
9+
branches: [ main ]
10+
pull_request:
11+
branches: [ main ]
12+
13+
# Allows you to run this workflow manually from the Actions tab
14+
workflow_dispatch:
15+
16+
# A workflow run is made up of one or more jobs that can run sequentially or in parallel
17+
jobs:
18+
# This workflow contains a single job called "ontology_qc"
19+
ontology_qc:
20+
# The type of runner that the job will run on
21+
runs-on: ubuntu-latest
22+
container: obolibrary/odkfull:v1.6
23+
24+
# Steps represent a sequence of tasks that will be executed as part of the job
25+
steps:
26+
# Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
27+
- uses: actions/checkout@v4
28+
29+
- name: Run ontology QC checks
30+
env:
31+
DEFAULT_BRANCH: main
32+
run: cd src/ontology && make ROBOT_ENV='ROBOT_JAVA_ARGS=-Xmx6G' test IMP=false PAT=false MIR=false
33+

.gitignore

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# ODK-managed rules, do not modify
2+
# If you need to add your own ignore rules, you may do so below
3+
# the "End ODK-managed rules" marker at the end of this file.
4+
.DS_Store
5+
semantic.cache
6+
bin/
7+
8+
*.tmp
9+
*.tmp.obo
10+
*.tmp.owl
11+
*.tmp.json
12+
*-relation-graph.tsv.gz
13+
.template.db
14+
15+
.github/token.txt
16+
17+
/idpo.owl
18+
/idpo.obo
19+
/idpo.json
20+
/idpo.db
21+
/idpo-base.*
22+
/idpo-basic.*
23+
/idpo-full.*
24+
/idpo-simple.*
25+
/idpo-simple-non-classified.*
26+
/mappings/
27+
/patterns/
28+
/reports/
29+
/subsets/
30+
31+
src/ontology/mirror
32+
src/ontology/mirror/*
33+
src/ontology/reports/*
34+
!src/ontology/reports/release-diff.md
35+
src/ontology/idpo.owl
36+
src/ontology/idpo.obo
37+
src/ontology/idpo.json
38+
src/ontology/idpo.db
39+
src/ontology/idpo-base.*
40+
src/ontology/idpo-basic.*
41+
src/ontology/idpo-full.*
42+
src/ontology/idpo-simple.*
43+
src/ontology/idpo-simple-non-classified.*
44+
45+
src/ontology/seed.txt
46+
src/ontology/dosdp-tools.log
47+
src/ontology/ed_definitions_merged.owl
48+
src/ontology/ontologyterms.txt
49+
src/ontology/simple_seed.txt
50+
src/ontology/patterns
51+
src/ontology/merged-idpo-edit.owl
52+
src/ontology/idpo-edit.properties
53+
54+
src/ontology/target/
55+
src/ontology/tmp/*
56+
!src/ontology/tmp/.gitkeep
57+
!src/ontology/tmp/README.md
58+
59+
src/ontology/run.sh.conf
60+
src/ontology/run.sh.env
61+
62+
src/ontology/imports/*_terms_combined.txt
63+
64+
src/patterns/data/**/*.ofn
65+
src/patterns/data/**/*.txt
66+
src/patterns/pattern_owl_seed.txt
67+
src/patterns/all_pattern_terms.txt
68+
69+
# End of ODK-managed rules

CONTRIBUTING.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# Contributing to Intrinsically Disordered Proteins Ontology
2+
3+
:+1: First of all: Thank you for taking the time to contribute!
4+
5+
The following is a set of guidelines for contributing to IDPO.
6+
These guidelines are not strict rules. Use your best judgment, and feel free to propose
7+
changes to this document in a pull request.
8+
9+
## Table Of Contents
10+
11+
- [Guidelines for Contributions and Requests](#contributions)
12+
* [Reporting problems with the ontology](#reporting-bugs)
13+
* [Requesting new terms](#requesting-terms)
14+
* [Adding new terms by yourself](#adding-terms)
15+
- [Best practices](#best-practices)
16+
* [How to write a great issue?](#great-issues)
17+
* [How to create a great pull/merge request?](#great-pulls)
18+
19+
<a id="contributions"></a>
20+
21+
## Guidelines for Contributions and Requests
22+
23+
<a id="reporting-bugs"></a>
24+
25+
### Reporting problems with the ontology
26+
27+
Please use our [Issue Tracker](https://github.com/BioComputingUP/idpo/issues/) for reporting problems with the ontology.
28+
To learn how to write a good issue [see here](#great-issues).
29+
30+
<a id="requesting-terms"></a>
31+
32+
### Requesting new terms
33+
34+
Before you write a new request, please consider the following:
35+
36+
- **Does the term already exist?** Before submitting suggestions for new ontology terms, check whether the term exist,
37+
either as a primary term or a synonym term. You can search for your term using [OLS](http://www.ebi.ac.uk/ols/ontologies/idpo).
38+
- **Can you provide a definition for the term?** It should be very clear what the term means, and you should be
39+
able to provide a concise definition, ideally with a scientific reference.
40+
- **Is the ontology in scope for the term?** Sometimes, it is hard to tell whether a term "belongs" in
41+
and ontology. A rule of thumb is "if a similar term already exists, the new term is probably in scope."
42+
It can be very helpful to mention a very similar concept as part of the term request!
43+
44+
#### Who can request a term?
45+
46+
Anyone can request new terms. However, there is not guarantee that your term will be added automatically. Since this is a
47+
community resource, it is often necessary to do at least some of the work of adding the term yourself, see below.
48+
49+
#### How to write a new term request
50+
51+
Request a new term _via_ the GitHub [Issue Tracker](https://github.com/BioComputingUP/idpo/issues/).
52+
53+
It is important to remember that it takes a lot of time for curators to process issues submitted to the tracker.
54+
To make this work easier, please always use issue templates if they are available (https://github.com/BioComputingUP/idpo/issues/new/choose).
55+
56+
For how to write a good term request, please read the [best practices carefully](#great-issues).
57+
58+
<a id="adding-terms"></a>
59+
60+
### How to add a new term
61+
62+
If you have never editted this ontology before, first follow a [general tutorial](https://oboacademy.github.io/obook/lesson/contributing-to-obo-ontologies)
63+
64+
**Process**:
65+
66+
1. Clone the repository (In case you are not an offical team member, create a fork first)
67+
1. Create new branch in git, for example `git checkout -b issue123`
68+
1. Open src/ontology/idpo-edit.owl in your favourite editor, i.e. [Protege](https://protege.stanford.edu/). **Careful:** double check you are editing the correct file. There are many ontology files in this repository, but only one _editors file_!
69+
1. Perform your edit and save your changes
70+
1. Commit changes to branch
71+
1. Push changes upstream
72+
1. Create pull request
73+
74+
## Best Practices
75+
76+
<a id="great-issues"></a>
77+
78+
### How to write great issues?
79+
80+
Please refer to the [OBO Academy term request guide](https://oboacademy.github.io/obook/howto/term-request/).
81+
82+
<a id="great-pulls"></a>
83+
84+
### How to create a great pull/merge request?
85+
86+
Please refer to the [OBO Academy best practices](https://oboacademy.github.io/obook/howto/github-create-pull-request/)

README.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
2+
![Build Status](https://github.com/BioComputingUP/idpo/actions/workflows/qc.yml/badge.svg)
3+
# Intrinsically Disordered Proteins Ontology
4+
5+
Description: None
6+
7+
More information can be found at http://obofoundry.org/ontology/idpo
8+
9+
## Versions
10+
11+
### Stable release versions
12+
13+
The latest version of the ontology can always be found at:
14+
15+
http://purl.obolibrary.org/obo/idpo.owl
16+
17+
(note this will not show up until the request has been approved by obofoundry.org)
18+
19+
### Editors' version
20+
21+
Editors of this ontology should use the edit version, [src/ontology/idpo-edit.owl](src/ontology/idpo-edit.owl)
22+
23+
## Contact
24+
25+
Please use this GitHub repository's [Issue tracker](https://github.com/BioComputingUP/idpo/issues) to request new terms/classes or report errors or specific concerns related to the ontology.
26+
27+
## Acknowledgements
28+
29+
This ontology repository was created using the [Ontology Development Kit (ODK)](https://github.com/INCATools/ontology-development-kit).

docs/cite.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# How to cite IDPO

docs/contributing.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
# How to contribute to IDPO

docs/index.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# IDPO Ontology Documentation
2+
3+
[//]: # "This file is meant to be edited by the ontology maintainer."
4+
5+
Welcome to the IDPO documentation!
6+
7+
You can find descriptions of the standard ontology engineering workflows [here](odk-workflows/index.md).
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Introduction to Continuous Integration Workflows with ODK
2+
3+
Historically, most repos have been using Travis CI for continuous integration testing and building, but due to
4+
runtime restrictions, we recently switched a lot of our repos to GitHub actions. You can set up your repo with CI by adding
5+
this to your configuration file (src/ontology/idpo-odk.yaml):
6+
7+
```
8+
ci:
9+
- github_actions
10+
```
11+
12+
When [updateing your repo](RepoManagement.md), you will notice a new file being added: `.github/workflows/qc.yml`.
13+
14+
This file contains your CI logic, so if you need to change, or add anything, this is the place!
15+
16+
Alternatively, if your repo is in GitLab instead of GitHub, you can set up your repo with GitLab CI by adding
17+
this to your configuration file (src/ontology/idpo-odk.yaml):
18+
19+
```
20+
ci:
21+
- gitlab-ci
22+
```
23+
24+
This will add a file called `.gitlab-ci.yml` in the root of your repo.
25+

0 commit comments

Comments
 (0)