-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
58 additions
and
25 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
name: continuous integration | ||
on: [push, pull_request] | ||
env: | ||
HCI_ROOT_DIR: "${{ github.workspace }}" | ||
permissions: | ||
contents: read | ||
jobs: | ||
check: | ||
runs-on: ubuntu-latest | ||
steps: | ||
- uses: actions/checkout@v4 | ||
- name: Setup Go 1.22 | ||
uses: actions/setup-go@v5 | ||
with: | ||
go-version: "1.22.x" | ||
- name: Set up Python 3.12 | ||
uses: actions/setup-python@v5 | ||
with: | ||
python-version: "3.12" | ||
- name: install Pipenv | ||
run: pip install pipenv --user | ||
- name: install dependencies | ||
run: pipenv sync --dev # Installs all deps, including dev deps, from Pipfile.lock. | ||
- name: format | ||
run: pipenv run invoke fmt | ||
- name: lint | ||
run: pipenv run invoke lint | ||
- name: check types | ||
run: pipenv run invoke build | ||
- name: run tests | ||
run: pipenv run invoke test |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
# Human Leukocyte Antigen (HLA) Curation Interface | ||
|
||
The HCI is under development. See our [roadmap](https://github.com/ClinGen/stanford-hci/issues/1) | ||
and our [docs](./doc). | ||
and our [docs](./doc). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,26 +1,26 @@ | ||
# Documentation | ||
|
||
- [Tutorials](./tutorial.md) (learning-oriented) | ||
- Tutorials are lessons that take the reader by the hand through a series of | ||
steps to complete a project of some kind. Unlike how-to guides, tutorials | ||
don't assume lots of prerequisite knowledge. | ||
- Tutorials are lessons that take the reader by the hand through a series of | ||
steps to complete a project of some kind. Unlike how-to guides, tutorials | ||
don't assume lots of prerequisite knowledge. | ||
- [How-to guides](./howto.md) (problem-oriented) | ||
- How-to guides take the reader through the steps required to solve a | ||
real-world problem. They are recipes, directions to achieve a specific end. | ||
Unlike tutorials, they typically assume a fair amount of prerequisite | ||
knowledge. | ||
- How-to guides take the reader through the steps required to solve a | ||
real-world problem. They are recipes, directions to achieve a specific end. | ||
Unlike tutorials, they typically assume a fair amount of prerequisite | ||
knowledge. | ||
- [Explanations](./explanation.md) (understanding-oriented) | ||
- Explanation, or discussions, clarify and illuminate a particular topic. They | ||
broaden the documentation’s coverage of a topic. Explanations can equally | ||
well be described as discussions; they are discursive in nature. They are a | ||
chance for the documentation to relax and step back from the software, | ||
taking a wider view, illuminating it from a higher level or even from | ||
different perspectives. You might imagine a discussion document being read | ||
at leisure, rather than over the code. | ||
- Explanation, or discussions, clarify and illuminate a particular topic. They | ||
broaden the documentation’s coverage of a topic. Explanations can equally | ||
well be described as discussions; they are discursive in nature. They are a | ||
chance for the documentation to relax and step back from the software, | ||
taking a wider view, illuminating it from a higher level or even from | ||
different perspectives. You might imagine a discussion document being read | ||
at leisure, rather than over the code. | ||
- Reference guides (information-oriented) | ||
- Reference guides are technical descriptions of the machinery and how to | ||
operate it. Reference guides have one job only: to describe. They are | ||
code-determined, because ultimately that’s what they describe: key classes, | ||
functions, APIs, and so they should list things like functions, fields, | ||
attributes and methods, and set out how to use them. For this project, | ||
reference is code comments (Go doc comments). | ||
- Reference guides are technical descriptions of the machinery and how to | ||
operate it. Reference guides have one job only: to describe. They are | ||
code-determined, because ultimately that’s what they describe: key classes, | ||
functions, APIs, and so they should list things like functions, fields, | ||
attributes and methods, and set out how to use them. For this project, | ||
reference is code comments (Go doc comments). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
# Explanations | ||
# Explanations |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
# How-to guides | ||
# How-to guides |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1 @@ | ||
# Tutorials | ||
# Tutorials |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters