Skip to content

UT-CHG/DS_Use_Case_template

 
 

Repository files navigation

DesignSafe Use Case Template

A guide to adding your use case project

  1. The PI should Fork the DS Use Case template from the GitHub repo to their own account. If prompted, select an organziation to create the fork.

    fork

    forking

    The PI can later add their students as collaborators in the settings page:

    collaborator

  2. GitHub will create a forked repo in your user account. Note, the new repo will say it was forked from the original https://github.com/DesignSafe-CI/DS_Use_Case_template/. forked-repo

  3. Navigate to your use case folder, which is located in the docs folder. The folders are named after the PI, so find the folder with your name to edit your template. Always check you are only editing your use case folder. PI use case folder

  4. Click on the usecase.md file in your usecase folder to edit your usecase. Edit usecase md

    Edited usecase

  5. Once you have completed editing your use case, you save your changes by commiting. Scroll down to the bottom of the page and type a descriptive phrase explaining the changes you have made and click "Commit changes". These changes will be saved only on your repo and will not be reflected in the original DS Use Case repository until you create a pull request.

    commit edits

  6. To add images to your use case, navigate to your use case folder and select img folder. Ensure that you are in your usecase img folder before adding images.

    img folder add image

  7. Select image files (you can select multiple files) and click add. Once the images are added as shown below, type a descriptive commit message and click Commit Changes to add relevant images to your folder.

    upload image

  8. To insert the image in your usecase.md file, use the following command:

    ![alternate text](image-location.png)
    

    In this case, we added an image called mpm-algorithm.png, which is located in the use case folder img. We can reference it in the text using:

    ![mpm algorithm](img/mpm-algorithm.png)
    

    Note: Use relative path img/mpm-algorithm.png, do not use full paths (e.g., "https://github.com/kks32/DS_Use_Case_Template/docs/kumar/img/mpm-algorithm.png").

    You can use the preview tab to check images and text formatting before commiting your changes.

    preview image

    Commit your changes to GitHub with a meaningful message.

    image commit

  9. Before you are ready to make changes to the original DS Use Case repo. Make sure your repository on GitHub is up to date with all the changes from the original repo. You can do this by navigating your repo and click on Fetch upstream. It should say nothing new to fetch. fetch upstream

    If there are any new changes you can fetch and merge. fetch merge

  10. Once you have completed making changes, you'll now create a Pull Request (PR) to request that your changes be merged to the main DesignSafe Use Case repo. Go to your repo on GitHub (in my case it is https://github.com/kks32/DS_Use_Case_Template). And select Contribute, check if it says This branch is XX comits **ahead** of DesignSafe-CI master, before opening a pull request:

    Open PR

    Complete the title and description of your PR and select Create Pull Request:

    Create PR

    The PR will show all the changes you have made in the Files Changed tab:

    PR changes

  11. After a minute or so a preview deployment of your use case will be available on the pull request page. Select the preview link generated by Netlify to view your changes similar to how it would be rendered in the final version. If you want to make some tweaks. Visit your GitHub repo of the DS Use Case and make changes. As long as the current PR remains open GitHub will automatically pull your changes.

    PR

    preview Web

Docker Image

A docker image of this environment is built and pushed to designsafeci/ds-use-case-template:latest on commits to master.

Python Poetry

The image uses python-poetry to install pinned python dependencies for fully reproducible builds.

Adding new packages

  1. Install python-poetry
  2. Run poetry add {package} --lock to add the dependency to the pyproject.toml file and the poetry.lock lockfile

N.B. This project uses a separate requirements.txt file for automated build previews.

Releases

No releases published

Packages

No packages published

Languages

  • Dockerfile 100.0%