Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Guide to how to add new layers #136

Closed
jywarren opened this issue Mar 8, 2019 · 12 comments · Fixed by #158
Closed

Guide to how to add new layers #136

jywarren opened this issue Mar 8, 2019 · 12 comments · Fixed by #158
Labels
documentation help wanted Extra attention is needed

Comments

@jywarren
Copy link
Member

jywarren commented Mar 8, 2019

Along with a layer submission system like #135 for people who find layers we'd like to add, we should have a README documentation section on how to actually add new layers in code. This could point at a PR which demonstrates everything you need to add one, for new coders to help out!

It could be like this file, although probably a lot simpler:

https://github.com/publiclab/image-sequencer/blob/main/CONTRIBUTING.md#contributing-modules

@jywarren jywarren added help wanted Extra attention is needed documentation labels Mar 8, 2019
@ephemeralwaves
Copy link
Member

I'd like to help work on this because I would like to work on #119 and I'm trying to figure out how exactly to go about adding a layer myself. Would anyone be able to help me through this process? So far I've gotten the data from #119 and found an npm module to get/add the lat/lng data into the csv file.

@sidntrivedi012
Copy link
Member

Thanks a lot @jywarren for this. Have been working on #116 but facing some issues. This will really ease the things a lot. 🎉

@jywarren
Copy link
Member Author

We may need some input from @sagarpreet-chadha on this, but basically, we add a new layer in the folder with the other layers, and for many layer types we can copy an existing one and modify it.

We should make a list of what's needed, and perhaps link to a PR or two of when other layers were added, as an example. But this may need to be an evolving guide, as we're also looking to make it easier to add new layers!

Here are a couple example PRs:

However, some of those layers were moved into their own code files in this PR, which is the preferred way to store them: #108

I hope this is at least a little helpful, but I think it's also a chicken and egg 🐔 🥚 problem because having a guide would help us keep this library more structured in the first place! Thank you for your interest and help!!! We're open to ideas here too! 👍 🎉

@rkpattnaik780
Copy link
Collaborator

Hello, I have recently worked on adding layers and I think I can describe the procedure of adding a layer that will be beginner friendly. I feel that providing examples in codepen and a descriptive tutorial along with sample PRs might also be helpful for a beginner. What do you feel @jywarren ?

@jywarren
Copy link
Member Author

jywarren commented Mar 13, 2019 via email

@rkpattnaik780
Copy link
Collaborator

@jywarren I think a new file CONTRIBUTING.md will be better. I will make the PR as soon as possible. :)

@jywarren
Copy link
Member Author

jywarren commented Mar 13, 2019 via email

@rkpattnaik780
Copy link
Collaborator

rkpattnaik780 commented Mar 28, 2019

@jywarren I have made a codepen sample where luftdaten layer has been implemented. Does it seem sufficient to be included as a sample for guide to add new layers ? We can provide a link to the PR that adds the layer also, I think this will give new contributors a fair idea on adding a new layer.

@jywarren
Copy link
Member Author

jywarren commented Mar 30, 2019 via email

rkpattnaik780 added a commit to rkpattnaik780/leaflet-environmental-layers that referenced this issue Mar 30, 2019
The contributing markdown is intended to serve as a short guide for new contributors. Currently it gives a short description about adding a new layer. Other guidelines can be added to it as well.

addresses publiclab#136
rkpattnaik780 added a commit to rkpattnaik780/leaflet-environmental-layers that referenced this issue Apr 1, 2019
Changes have been made to the contributing markdown as suggested in review.

fixes publiclab#136
jywarren pushed a commit that referenced this issue Apr 8, 2019
* docs: create CONTRIBUTING.md

The contributing markdown is intended to serve as a short guide for new contributors. Currently it gives a short description about adding a new layer. Other guidelines can be added to it as well.

addresses #136

* docs: update CONTRIBUTING.md

Changes have been made to the contributing markdown as suggested in review.

fixes #136
@jywarren
Copy link
Member Author

Hi @crisner, just putting this on your radar. With all the fantastic work that's gone into this library, perhaps we should revisit the "adding a layer" docs in CONTRIBUTING.md - maybe adding the "spreadsheet layers" too, like #154?

@jywarren
Copy link
Member Author

Ah, actually we have some suggested text for spreadsheet layers here! #121

@crisner
Copy link
Contributor

crisner commented Jan 23, 2020

I guess this issue #243 is related?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation help wanted Extra attention is needed
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants