# First-time contributors

**URL:** <https://openmc.discourse.group/t/first-time-contributors/2896>\
**Category:** Development\
**Created:** [April 5, 2023, 7:41pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896 "2023-04-05T19:41:14Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 5, 2023, 7:41pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/1 "2023-04-05T19:41:14Z")

</div>

Hi all,

I am a student at the University of Michigan and I’m taking a Software Engineering course here. Our last homework is to contribute to an open-source project and my partner and I have decided to try contributing to OpenMC for the next couple of weeks!

We would really appreciate any feedback or information that may be helpful to us during this process. Our initial plan was to take a look at Issue #2123 ([Weight window bounds ordering · Issue #2123 · openmc-dev/openmc · GitHub](https://github.com/openmc-dev/openmc/issues/2123)). However, during the process of reading through the Developer’s Guide, we found that two issues were tagged for first time contributors. We would also appreciate your opinion on our contribution to Issue #2123 and whether or not there may be better issues for us to work on.

Thank you.

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 5, 2023, 7:44pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/2 "2023-04-05T19:44:02Z")

</div>

We were also unable to join the slack for OpenMC because we did not have an email domain that matched. Would it be helpful for us to join the slack or is it okay that we are unable to be on it?

---

<div class="post-metadata">

**Author:** ![Shimwell](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/shimwell/32/3876_2.png) [@Shimwell](https://openmc.discourse.group/u/Shimwell)\
**Post date:** [April 5, 2023, 9:03pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/3 "2023-04-05T21:03:20Z")

</div>

Hi ywkim1025

Welcome to the community.

I did take a look at the two issues labeled as “first timers only” and I’m wondering if those issues are slightly out of date now as they were made in 2017 and 2018.

I’m sure we can find you a nice issue to work on. I think @April was making a nice collection of “first timer” issues just today.

Perhaps we can raise a couple of issues for you and tag you on GitHub. Could you let us know your GitHub usernames?

Something that jumps to mind as straight forward and always welcome is additional type hinting on the python arguments. It is not the most interesting PR but helps get an overview of the code. If you are keen you could add some type hinting to any python file that is missing type hinting. Take a look in [this](https://github.com/openmc-dev/openmc/tree/develop/openmc) folder to find a relevant file.

I have done a few type hinting PRs that helped establish where we want them (on method and function args and return statements, but not on getters and setters). Perhaps these example PRs help [Pull requests · openmc-dev/openmc · GitHub](https://github.com/openmc-dev/openmc/pulls?q=is%3Apr+is%3Aclosed+type+hinting)

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 6, 2023, 4:47pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/4 "2023-04-06T16:47:33Z")

</div>

Thank you so much!

Our Github usernames are: christinacai123 and youngwki. We really appreciate your help.

We’ll also keep the type hinting tasks in mind.

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 7, 2023, 7:14pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/5 "2023-04-07T19:14:13Z")

</div>

In the meantime, we are currently working on type hinting for file weight\_windows.py!

---

<div class="post-metadata">

**Author:** ![yrrepy](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/yrrepy/32/2365_2.png) [@yrrepy](https://openmc.discourse.group/u/yrrepy)\
**Post date:** [April 10, 2023, 3:43pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/6 "2023-04-10T15:43:53Z")

</div>

Hi Kim,

do you need suggestions for tasks to work on?

I’m not a developer, mostly a user, but I do have a laundry list of stuff I’m trying to get into OpenMC, some easier, some harder.

Perry

---

<div class="post-metadata">

**Author:** ![paulromano](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/paulromano/32/486_2.png) [@paulromano](https://openmc.discourse.group/u/paulromano)\
**Post date:** [April 10, 2023, 7:55pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/7 "2023-04-10T19:55:59Z")

</div>

@ywkim1025 Thanks to both you and Christina for your contributions (present and future)! If you want to continue on the type hinting path, in my opinion the ones that would be particaruly valuable are the classes that are most often used, including: `openmc.Model`, `openmc.Geometry`, `openmc.Materials`, `openmc.Material`, `openmc.Cell`, `openmc.Universe`, etc. Happy to sketch out a full list of priority classes/functions if it would be useful.

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 12, 2023, 5:28pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/8 "2023-04-12T17:28:05Z")

</div>

Hi Perry!

If you have a list of tasks we could work on, we would be super open to hear about it!

I would ask that you provide us a relatively wide range of difficulties in the tasks (but maybe not so much of the hard) because we are very new to this project. While we don’t know if we will be able to get to those tasks and complete them for sure, we can definitely try it out.

Please feel free to provide us a list. Thank you so much for helping us!

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 12, 2023, 5:28pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/9 "2023-04-12T17:28:40Z")

</div>

Thank you! We will finish up the one we are currently working on and then move onto the ones you pointed us to.

---

<div class="post-metadata">

**Author:** ![ywkim1025](https://avatars.discourse-cdn.com/v4/letter/y/9f8e36/32.png) [@ywkim1025](https://openmc.discourse.group/u/ywkim1025)\
**Post date:** [April 13, 2023, 7:33pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/10 "2023-04-13T19:33:57Z")

</div>

Hi all,

Our homework actually requires us to complete a task where we can complete some sort of QA activities. Whether it’s using Travis CI or using analysis tools, we must do some sort of testing.

I was wondering if there are any other task suggestions that may allow for us to do this that aren’t too difficult for first-time contributors to complete. We are still working on type hinting but we figured it may be good to also work on other tasks!

Thank you.

---

<div class="post-metadata">

**Author:** ![Shimwell](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/shimwell/32/3876_2.png) [@Shimwell](https://openmc.discourse.group/u/Shimwell)\
**Post date:** [April 13, 2023, 7:41pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/11 "2023-04-13T19:41:51Z")

</div>

Oh yes I have an idea for that

This shows the lines of code our tests cover

> **[Coveralls.io - Test Coverage History and Statistics](https://coveralls.io/github/openmc-dev/openmc?branch=develop)**
>
> The leading provider of test coverage analytics. Ensure that all your new code is fully covered, and see coverage trends emerge. Works with most CI services. Always free for open source.

You can use it to identify some untested lines and design a pytest that hits those lines

---

<div class="post-metadata">

**Author:** ![paulromano](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/paulromano/32/486_2.png) [@paulromano](https://openmc.discourse.group/u/paulromano)\
**Post date:** [April 13, 2023, 7:51pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/12 "2023-04-13T19:51:29Z")

</div>

Another thought since you’ve been working on type hinting – one thing we could add is some static type checking in our CI by using [mypy](https://mypy-lang.org/), [pyright](https://github.com/microsoft/pyright), or another static type checker. That is, given the type hints that now appear in the code, does our own internal use of functions/classes obey those type hints. If not, that’s a good indication that either the code is wrong or the type hints are wrong.

---

<div class="post-metadata">

**Author:** ![christinac](https://avatars.discourse-cdn.com/v4/letter/c/3da27b/32.png) [@christinac](https://openmc.discourse.group/u/christinac)\
**Post date:** [April 17, 2023, 6:32pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/13 "2023-04-17T18:32:53Z")

</div>

Sounds great! Would making a new folder in regression tests called typehint and including an **init**.py and test.py where we run mypy on all of the files that we have added type hinting to work?

---

<div class="post-metadata">

**Author:** ![Shimwell](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/shimwell/32/3876_2.png) [@Shimwell](https://openmc.discourse.group/u/Shimwell)\
**Post date:** [April 17, 2023, 10:29pm UTC](https://openmc.discourse.group/t/first-time-contributors/2896/14 "2023-04-17T22:29:06Z")

</div>

I’m not sure if the repo is ready for something like this but I have been looking at a GitHub action that runs mypy like this [Mypy for Python | Github Action. Mypy is an incredibly useful tool for… | by doedotdev | Medium](https://doedotdev.medium.com/mypy-for-github-action-7da1ebee99e7)

What do others think? Should we run mypy as a GitHub action?

---

<div class="post-metadata">

**Author:** ![paulromano](https://yyz2.discourse-cdn.com/free1/user_avatar/openmc.discourse.group/paulromano/32/486_2.png) [@paulromano](https://openmc.discourse.group/u/paulromano)\
**Post date:** [April 18, 2023, 3:59am UTC](https://openmc.discourse.group/t/first-time-contributors/2896/15 "2023-04-18T03:59:04Z")

</div>

Yes, the proper thing to do would be to run it as a GitHub action as you suggest @Shimwell. Note that I just tried this locally (`mypy openmc`) and got nearly 200 errors 😱 It looks like most of them have to do with mypy not being happy when a property getter/setter don’t appear next to each other. So, that might be another item of work — run mypy locally and start working through these errors; I suspect many of them will be easy to fix.
