Skip to content

Commit

Permalink
Merge pull request #514 from Stockless/docs-develop
Browse files Browse the repository at this point in the history
Fix asset paths for "5-contribute-to-koma.md"
  • Loading branch information
cncastillo authored Dec 4, 2024
2 parents 7f4c560 + fac4f59 commit 6ebffff
Showing 1 changed file with 15 additions and 33 deletions.
48 changes: 15 additions & 33 deletions docs/src/how-to/5-contribute-to-koma.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,9 @@ If you try to commit or generate a pull request at this point, you will get an `

To create this fork, go to the official [KomaMRI repository](https://github.com/JuliaHealth/KomaMRI.jl) and follow the steps below:

```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/create-fork-step1.png" >
<img src="/./../docs/build/assets/create-fork-step2.png" >
</svg>
```
![](../assets/create-fork-step1.png)
![](../assets/create-fork-step2.png)

### 3. Access your GitHub account in VSCode

Now, you need to ensure that your GitHub account is connected to VSCode. This allows you to clone repositories, create branches, and manage pull request directrly within VSCode.
Expand All @@ -51,18 +48,13 @@ In VSCode, click on **File** -> **Open Folder...** and select your `~/.julia/dev
Now add the fork URL by clicking **Source Control** -> **...** -> **Remote** -> **Add Remote...**
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/add-remote.png" width=700px/>
</svg>
<img width="80%" src="../../assets/add-remote.png">
```
This will create the option to provide a repository URL. Here is where you will paste your fork URL and give it the name `my-fork`.
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/create-remote-step1.png" />
<img src="/./../docs/build/assets/create-remote-step2.png" />
</svg>
```
![](../assets/create-remote-step1.png)
![](../assets/create-remote-step1.png)
>💡Press `Yes` when prompted to constantly fetch in the future.
The Julia extension should automatically detect the `KomaMRI` environment. To check this, look at the status bar (bottom) end you should see `Julia env: KomaMRI`. If this is not the case, click the option in the menu bar and select KomaMRI.jl.
Expand Down Expand Up @@ -103,18 +95,14 @@ If you did correctly follow the previous steps you will have correctly created y
To create this new branch, go to **Source Control** -> **...** -> **Branch** -> **Create Branch form...**
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/add-branch.png" width=700px/>
</svg>
<img width="80%" src="../../assets/add-branch.png">
```
This will open a menu to select an starting point for your branch. Select `my-fork/master` as your starting point, and give it the name `my-new-feature`.
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/create-branch-step1.png" />
<img src="/./../docs/build/assets/create-branch-step2.png" />
</svg>
```
![](../assets/create-branch-step1.png)
![](../assets/create-branch-step1.png)
>💡In your VScode terminal use `git status` to check if your branch is correctly created. Your branch should be listed at the top of the output.
## How to commit
Expand All @@ -126,9 +114,7 @@ To do this, in VScode go to the Source Control panel in the Activity Bar.
Assuming you are currently in your `my-new-feature` branch, the Source Control panel should show your changes to the project and the option to create a commit message.
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/how-to-commit.png" width=500px/>
</svg>
<img width="60%" src="../../assets/how-to-commit.png">
```
If you hove over the `Changes` tab, it should show a `+` icon. Press it to stage all changes in the project.
Expand All @@ -145,19 +131,15 @@ If you want to send your commited new version of the repository, you can create
To create this pull request, in VScode, go to the `GitHub Pull Request` panel in the Activity Bar and hove over the `Pull request` tab. This should show a Create pull request icon to press.
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/create-pull-request.png" width=500px/>
</svg>
<img width="60%" src="../../assets/create-pull-request.png">
```
In the `Create` tab that appears, select `JuliaHealth/master` as the base and the branch you are working with to merge.
To finish your pull request, give it a name with a clear mention of the subject of the contribution you made, and a description that explains the issue or feature you are addresing in your branch, and press the Create button.
```@raw html
<svg style="display: block; margin: 0 auto;" width="5em" height="5em">
<img src="/./../docs/build/assets/fill-pull-request.png" width=500px/>
</svg>
<img width="60%" src="../../assets/fill-pull-request.png">
```
>💡 **Tips for a successful Pull Request:**
> - Try to address one issue or feature per pull request to make it easier for reviewers.
Expand Down

0 comments on commit 6ebffff

Please sign in to comment.