internetarchive / openlibrary

One webpage for every book ever published!
https://openlibrary.org
GNU Affero General Public License v3.0
5.18k stars 1.35k forks source link

Quickstart guide linked in the documentation is a dead link #9318

Open JoleneRenee21 opened 5 months ago

JoleneRenee21 commented 5 months ago

Problem

There is a link to the Quickstart guide in both the README and CONTRIBUTING documentation that no longer works - it redirects to "Create new page" for the wiki. I have located the Outdated Getting Started wiki page which I believe was previously the destination of the documentation link. Since much of the content on this guide is outdated, I would recommend changing the documentation to point to Start Here and/or Common Setup Tasks as a temporary replacement for some of the quick information, such as admin login credentials and frequently needed docker commands. These were the best replacements I could find in the wiki for the not outdated info that may be helpful. I can make these changes to the documentation with confirmation that these would be appropriate replacements or given another alternative.

Evidence / Screenshot

image

Relevant URL(s)

README CONTRIBUTING Quickstart

Reproducing the bug

  1. Go to the README or CONTRIBUTING files.
  2. Locate the Quickstart link and click on it.

Context

Notes from this Issue's Lead

Proposal & constraints

Related files

Stakeholders

asudox commented 4 months ago

Looking at the latest archive of the quickstart guide, there was a text mentioning how outdated it was and that it has to be rewritten. They most likely removed it for the time being as the guide gets rewritten.

https://web.archive.org/web/20240324115306/https://github.com/internetarchive/openlibrary/wiki/Getting-Started

rebecca-shoptaw commented 4 months ago

@Asudox Yes, there is an onboarding overhaul in progress, but it would still be good to point these links to Start Here for now so that new contributors don't get confused!

AbhinavKRN commented 3 months ago

@rebecca-shoptaw is this issue available?

rebecca-shoptaw commented 3 months ago

@AbhinavKRN I believe @JoleneRenee21 is still working on it -- we're waiting on a final decision re: where the link should go instead.

JoleneRenee21 commented 3 months ago

Yes, just waiting on the decision and then will update again :)

rebecca-shoptaw commented 3 months ago

@JoleneRenee21 sounds good! will double-check to see if any progress has been made on that front! :)

AbhinavKRN commented 3 months ago

@rebecca-shoptaw any update?

rebecca-shoptaw commented 3 months ago

@AbhinavKRN To clarify, the issue is not available, we're waiting on an update to get it finished. There should be plenty of other good first issues available or opening up soon if you'd like to find something to work on 🙂

AbhinavKRN commented 3 months ago

@rebecca-shoptaw Actually i have commented on some, can you please check it and reply. It would be a great help.