shanselman / firsttimersonly

The Repository for the FirstTimersOnly movement in Open Source. We want projects to reserve some issues for newbies.

FirstTimersOnly

This Repository is for the FirstTimersOnly movement in Open Source. We want projects to reserve some issues for newbies. Visit our live webpage at https://www.firsttimersonly.com/

Empower a First Timer today!

We believe - and we hope you believe too - that learning how to code, how to think, and how to contribute to open source can empower the next generation of coders and creators. We VALUE first time contributors and we want them to know that everyone started somewhere!

We have gathered a list of resources to motivate and empower you to making that first step into becoming a contributor to the open source realm.

If you are an OSS project owner, we have some tips for you to enable you to be instrumental in ushering a new batch of programmers into the community.

An initiative by SHANSELMAN and KENTCDODDS

firsttimersonly's Issues

Missing Shield Badges in Readme

The site says:

And add this badge to your repo's README:

however its not in the README of this repo.

Set gh-pages as Default Branch

In the settings section of the repo, you can set the default branch for the project. Might make life a little easier. :P

Spelling errors

Resources are outdated

Many resources mentioned like https://goodfirstissue.dev/ are no longer actively maintained. If the firsttimersonly project not being actively maintained or contributed to - should the web domain be redirecting to something that is being maintained? That would greatly help all the website visitors because https://www.firsttimersonly.com/ is mentioned on tons of places across the web.

Or a "Not actively maintained banner" can be put on the webpage.

PS - I really appreciate the help the project has been doing to new contributors like me since a long time.

HTTP 410 Response with link in index.md

Hi! Thank you for making this project!
As I was reading, I noticed on this line, the link:

https://medium.com/@kentcdodds/first-timers-only-78281ea47455

returns the HTTP error response: "410 - The author deleted this medium story". Thus, the link is now invalid.

More accessible, inclusive styling.

I was wondering if we could update the site styling so it's more inclusive? I find the text really hard to read at the moment since it's so small.

html, body {
    font-size: 20px;
    font-family:
      -apple-system,
      BlinkMacSystemFont,
      "Segoe UI",
      "Roboto",
      "Oxygen",
      "Ubuntu",
      "Cantarell",
      "Fira Sans",
      "Droid Sans",
      "Helvetica Neue",
      sans-serif;
    line-height: normal;
    margin: 1rem;
}

h3 {
    margin-top: 2rem;
}

h2 {
    margin-top: 2rem;
    margin-bottom: 2rem;
}

p, ul {
    line-height: 1.5;
    margin-bottom: 1.5rem;
}

ul {
    padding-left: 0;
}
li {
    margin-bottom: .5rem;
}

pre {
    overflow-y: auto;
}

.shell {
    margin: auto;
    max-width: 35em;
}

`Rephrase About first timers only`

I think the 'About' section should be rephrased for easy digestion and communication for new users. For instance, presently, we have: The Repository for the FirstTimersOnly movement in Open Source. We want projects to reserve some issues for newbies.

The above statement does not seem direct for new users consumption.

The above statement does not seem direct for new users consumption.

I think the 'About' section should be rephrased for easy digestion and communication for new users. For instance, presently, we have: The Repository for the FirstTimersOnly movement in Open Source. We want projects to reserve some issues for newbies.

Add link to github pages site in repo description

Since a lot of new comers are not familiar with github pages, they may not be aware of how to find the webpage from the repo. Adding a link to it in either the description or readme would help with that.

First time

Retaining women in open source: Organising open source day monthly

Hi folks: Finding an active open source contributor or maintainer woman is hard. Internships give a break in open source, if observed there is no retention of women in open source and research[1] suggests. Implementing open source day per month letting woman work with mentor and contribute in an open source project they would like would be practical implementation than just publishing research and articles. Lemme know if you would interested in supporting and I will share further things.

[1] https://en.wikipedia.org/wiki/Diversity_in_open-source_software

project needs a 'first-timers-only' labelled issue

please create an issue labelled 'first-timers-only' here

:)

A hands on tutorial to get started

I've started on a project to help first timers get started on doing open source contributions.

Currently its a hands on tutorial for doing open source contributions through github.

Here's the repo https://github.com/Roshanjossey/first-contributions

I'd love it it this is also added to first timers only. Could you share your thoughts on the same?

Fix one of our spelling errors

@first_tmrs_only tweet bot.

I created a tweet bot which tweets about First timers only issues on Github @first_tmrs_only, which are otherwise not very discoverable on Github alone.

Shall I make a PR to include a link to it on the page?

Typo on Webiste

From the website firsttimersonly, there's a typo. It says, "...when you complete the turorial". I inserted a screenshot below and made it so that the typo is at the bottom of it.

Great start, but what about code of conduct

I don't think the actual problem lays with people that are "scared" to contribute. I never spoke to a person that was afraid to do a PR, but I have spoken to people that are demanding but refusing to contribute in any way.

I think by creating a code of conduct (a standardized one), people can point these (unaware) demanding users to that page to create awareness.

I am not talking about people asking questions, I am talking about people "demanding" features (as a good example, strong naming). I recently saw this:

A rando commenter on GitHub decided to tell me to "Strong name ReactiveUI or take it off NuGet". Seriously considering the latter right now.

— Paul Betts (@paulcbetts) August 5, 2015

<script async src="//platform.twitter.com/widgets.js" charset="utf-8"></script>

I think that is part of what's wrong with the OSS world. Because of approaches by people this way, OSS authors build a level of frustration. This, in the end, might lead to a rude-looking response to newcomers, scaring them off.

The combination of a code of conduct and firsttimersonly can be a double-edged sword. It creates awareness for OSS users how much work is involved in getting a library up and running and supporting that. It should never be taking for granted. Once this awareness is created, they might think: "hey, this is a cool library. Let's contribute, but I have no idea how to start." Then any OSS library can point to the firsttimersonly guide and indeed have a few issues.

Note that the default responses are:

1. We need this feature finished by monday
2. I am too busy
3. I also have a family, want to spend time with them

If we can create awareness of their (unintended) behavior, we might get them to contribute and help out a bit as well. And note there are a lot of ways people can contribute:

1. Write docs
2. Write examples
3. Write blog posts
4. Pull requests
5. etc

I think 1 / 2 / 3 could also be included in the firsttimersonly. People forget that even writing docs is a great way to learn a system and contribute to OSS.

Trail issue

Trail issue creation

Outdated Link to First contributions

I noticed that the link to the First contributors in this line is outdated. The repo has been moved under the first contributions org and the new link would be https://github.com/firstcontributions/first-contributions

Changes proposed in index.md

- * [First contributions](https://github.com/multunus/first-contributions) is a hands-on tutorial that walks you through contributions workflow on GitHub. When you complete the tutorial, you have made a contribution to the same project.
+ * [First contributions](https://github.com/firstcontributions/first-contributions) is a hands-on tutorial that walks you through contributions workflow on GitHub. When you complete the tutorial, you have made a contribution to the same project.

This is a great first issue for beginners 😛