publiclab / community-toolbox

Tools to understand and welcome people into a contributor community
https://code.publiclab.org
MIT License
142 stars 197 forks source link

Update broken links in index.html page #568

Closed on2onyekachi closed 2 years ago

on2onyekachi commented 2 years ago

Hi, this is a first-timers-only issue. This means we've worked to make it more legible to folks who either haven't contributed to our codebase before, or even folks who haven't contributed to open source before.

If that's you, we're interested in helping you take the first step and can answer questions and help you out as you do. Note that we're especially interested in contributions from people from groups underrepresented in free and open source software!

We know that the process of creating a pull request is the biggest barrier for new contributors. This issue is for you πŸ’

If you have contributed before, consider leaving this one for someone new and looking through our general help wanted issues. Thanks!

πŸ€” What you will need to know.

Nothing. This issue is meant to welcome you to Open Source :) We are happy to walk you through the process.

πŸ“‹ Step by Step

See this page for some help in taking your first steps!

Below is a "diff" showing in red (and a -) which lines to remove, and in green (and a +) which lines to add:


Necessary changes in index.html file

Link to be changed to our README

-157: <p>If you're new, and looking to get involved, you're in the right place. Check out <a  id="readme-link" href="https://github.com/publiclab/plots2/blob/master/README.md">our README</a> to get started.</p>
+157: <p>If you're new, and looking to get involved, you're in the right place. Check out <a  id="readme-link" href="https://github.com/publiclab/plots2/blob/main/README.md">our README</a> to get started.</p>

Link to be changed to open an issue

-161: <p>If you have trouble, check out <a  id="chat1" href="https://publiclab.org/chat">our chatroom</a> to ask for help, or you can talk directly with the other contributors on <a  id="chat2" href="https://gitter.im/publiclab/publiclab">our Gitter chatroom</a> or just <a  id="createissue" href="https://github.com/publiclab/plots2/issues/new">open an issue</a> and we'll write back!</p>
+161: <p>If you have trouble, check out <a  id="chat1" href="https://publiclab.org/chat">our chatroom</a> to ask for help, or you can talk directly with the other contributors on <a  id="chat2" href="https://gitter.im/publiclab/publiclab">our Gitter chatroom</a> or just <a  id="createissue" href="https://github.com/publiclab/plots2/issues/new/choose">open an issue</a> and we'll write back!</p>

Link to be changed prepare new first-timers-only issues here

-215: <p>No issues left? See <a href="/#r=all">issues across this org here</a>, and see the almost-as-good "<span class=" newcomer-like-issues">candidates</span>" below. Or learn how to <a href="">prepare new <b><span  id="issue-label-for-newcomer">first-timers-only</span> </b> issues here</a>.</p>
+215: <p>No issues left? See <a href="/#r=all">issues across this org here</a>, and see the almost-as-good "<span class=" newcomer-like-issues">candidates</span>" below. Or learn how to <a href="https://publiclab.org/notes/warren/10-31-2016/create-a-welcoming-first-timers-only-issue-to-invite-new-software-contributors">prepare new <b><span  id="issue-label-for-newcomer">first-timers-only</span> </b> issues here</a>.</p>

Necessary changes in config.json file

-9: "README-link": "https://github.com/publiclab/plots2/blob/master/README.md",
+9: "README-link": "https://github.com/publiclab/plots2/blob/main/README.md",

Necessary changes in configure.js file

-14: $('#createissue').attr("href", `https://github.com/${data['org']}/${data['default-repository']}/issues/new`)
+14: $('#createissue').attr("href", `https://github.com/${data['org']}/${data['default-repository']}/issues/new/choose`)
-15: $('#support-issues').attr("href", `https://github.com/${data['org']}/${data['default-repository']}/labels/${data['support-issue-label']}'`)
+15: $('#support-issues').attr("href", `https://github.com/${data['org']}/${data['default-repository']}/labels/${data['support-issue-label']}`)
  1. If you are familiar with the terminal or would like to learn it, here is a great tutorial on how to send a pull request using the terminal.

  2. You can also edit files directly in your browser and open a pull request from there.

Please keep us updated

πŸ’¬β° - We encourage contributors to be respectful to the community and provide an update within a week of claiming a first-timers-only issue. We're happy to keep it assigned to you as long as you need if you update us with a request for more time or help, but if we don't see any activity a week after you claim it we may reassign it to give someone else a chance. Thank you in advance!

If this happens to you, don't sweat it! Grab another open issue.

Is someone else already working on this?

πŸ”—- We encourage contributors to link to the original issue in their pull request so all users can easily see if someone's already started on it.

πŸ‘₯- If someone seems stuck, offer them some help! Otherwise, take a look at some other issues you can help with. Thanks!

πŸ€”β“ Questions?

Leave a comment below, and reach out in our chatroom!

on2onyekachi commented 2 years ago

@TildaDares Please do have a review on this issue if it's exactly what needs to be done. . that reflects https://github.com/publiclab/community-toolbox/issues/557#issuecomment-1120487866

TildaDares commented 2 years ago

@on2onyekachi From your comment in https://github.com/publiclab/community-toolbox/issues/557#issuecomment-1120487866, we can remove issues across this org here. Also can you change the readme links to this. Thanks!!

on2onyekachi commented 2 years ago

Sure, done!. it is updated now.

VictoriaAjala commented 2 years ago

Hello @TildaDares @on2onyekachi Can I work on this issue?

TildaDares commented 2 years ago

Great work @on2onyekachi. Thank you!!

TildaDares commented 2 years ago

Hi @VictoriaAjala, we usually leave easy issues like this for first-timers. Thanks!!

TildaDares commented 2 years ago

Reserved for @YorhaBlue for 24 hours!

YorhaBlue commented 2 years ago

Thank you @TildaDares -- added the changes and started pull requests for index.html, config.json, configure.js.