image-sequencer icon indicating copy to clipboard operation
image-sequencer copied to clipboard

Load Image Docs Link Should Not Be Displayed (as it doesn't exist)

Open harshkhandeparkar opened this issue 5 years ago • 20 comments

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 is to be done?

The first step in every sequence of ImageSequencer is the load-image step where the input image is loaded. This is just a sequencer method and not an actual module. It has no dedicated documentation.

All the other modules of ImageSequencer have their own docs here

Even though load-image has no docs, there is a link in the UI for load-image which leads to nothing. Screenshot from 2020-01-17 23-35-45

Files to refer to:

  1. https://github.com/publiclab/image-sequencer/blob/d1b9b8beccdbe5ba98cf4e352af103b4913a5fe6/examples/lib/defaultHtmlStepUi.js#L48-L50

🤔 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

  • [ ] 🙋 Claim this issue: Comment below. If someone else has claimed it, ask if they've opened a pull request already and if they're stuck -- maybe you can help them solve a problem or move it along!

  • [ ] 📝 Modify the file defaultHtmlStepUi.js

  • [ ] 💾 Commit your changes

  • [ ] 🔀 Start a Pull Request. There are two ways how you can start a pull request:

  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.

  • [ ] 🏁 Done Ask in comments for a review :)

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 it 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!

harshkhandeparkar avatar Jan 17 '20 18:01 harshkhandeparkar

I want to work on this issue. can you elaborate, what I am supposed to do in this ?

pcube99 avatar Jan 17 '20 18:01 pcube99

You have to make it so that only the first step has no link.

harshkhandeparkar avatar Jan 17 '20 18:01 harshkhandeparkar

All the other steps' description should be clickable.

harshkhandeparkar avatar Jan 17 '20 18:01 harshkhandeparkar

so I just need to put an If statement or an ternary operator and check that step.name is load-image or not.

If it is load-image then remove the link otherwise redirect it.

pcube99 avatar Jan 17 '20 18:01 pcube99

Yeah. Great! You can ask for help here. We are always ready to help.

harshkhandeparkar avatar Jan 17 '20 18:01 harshkhandeparkar

@HarshKhandeparkar please check the PR.

pcube99 avatar Jan 17 '20 19:01 pcube99

This one is open :)

harshkhandeparkar avatar Jul 08 '20 05:07 harshkhandeparkar

I want to work on this issue, how should i proceed?

ashirbad29 avatar Sep 26 '20 10:09 ashirbad29

Just follow the steps mentioned in the issue body @ashirbad29 :) If there is any doubt, please ask.

harshkhandeparkar avatar Sep 26 '20 10:09 harshkhandeparkar

In short, as you can see in that code, it tries to generate a link to the docs but the link doesn't always exist. Instead of dynamically generating, you can use step['docs-link'] because all the links have been manually written under that parameter. Just check if step['docs-link'] exists, if it does then only show the link.

harshkhandeparkar avatar Sep 26 '20 12:09 harshkhandeparkar

since its a small issue i change the code in the browser, should I need to test the code first by npm-run-test

ashirbad29 avatar Sep 28 '20 15:09 ashirbad29

@HarshKhandeparkar please review my PR :)

ashirbad29 avatar Sep 28 '20 15:09 ashirbad29

since its a small issue i change the code in the browser, should I need to test the code first by npm-run-test

Not really, I don't think that part even has a test.

harshkhandeparkar avatar Sep 28 '20 18:09 harshkhandeparkar

@HarshKhandeparkar I worked on your suggestion and made changes, please review it

ashirbad29 avatar Sep 29 '20 11:09 ashirbad29

@HarshKhandeparkar Can I work on this?

GuptaTanisha avatar Feb 17 '21 13:02 GuptaTanisha

It was actually fixed by the other PR but the PR has a conflict. Maybe you can revive that PR?

harshkhandeparkar avatar Feb 17 '21 13:02 harshkhandeparkar

Hi @HarshKhandeparkar ! I am very exited to work on this issue , if it is still open . I have learnt web development from coding ninjas and all my basic concepts are clear . I am very hardworking and have scored 94.2% in 12th . You can also go through my linkedIn profile - https://www.linkedin.com/in/tanish-a54b771b3 . Looking forward for your reply .

SharmaTanish avatar Feb 22 '21 15:02 SharmaTanish

Sure!

harshkhandeparkar avatar Feb 22 '21 15:02 harshkhandeparkar

is someone working on this issue? or having problems solving it? i also want to solve this issue

pawanmkr avatar Apr 14 '23 03:04 pawanmkr

@harshkhandeparkar if the issue is still open, I would like to work on this

Demon-Sheriff avatar Aug 04 '24 07:08 Demon-Sheriff