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

[DOC] : Add documentation to the dssg directory README on the organization of code. #10

Open
sunayana opened this issue Apr 21, 2021 · 5 comments
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@sunayana
Copy link
Collaborator

No description provided.

@sunayana sunayana added the documentation Improvements or additions to documentation label Apr 21, 2021
@sunayana sunayana self-assigned this Apr 21, 2021
@cmougan
Copy link
Owner

cmougan commented Apr 21, 2021

With this you mean describe in a paragraph all the sections?

@rohaan2614
Copy link
Contributor

Hey @sunayana , I see this is self-assigned but can I help with this?
(I don't fully understand the issue description though, a little clarification will help :) )

@sunayana
Copy link
Collaborator Author

Hi @rohaan2614 thanks, that would be great, if you could do that, I would have done it next week otherwise.
It is more about creating a documentation for the code, something along the lines https://developer.lsst.io/python/numpydoc.html
And then compile it to markdown files or rst files. This would mean to go through the code in the dssg/dataio folder mainly and add comments, something along these lines

"""Sum numbers in an array.

Parameters
----------
values : iterable
   Python iterable whose values are summed.

Returns
-------
sum : `float`
   Sum of ``values``.
"""

I would look into it Monday or Tuesday next week otherwise.

@rohaan2614
Copy link
Contributor

rohaan2614 commented Apr 23, 2021

I will add some on Sunday. You can review them on Monday or whenever you have time.

Just to confirm, this is the directory of those codes, right?

@sunayana
Copy link
Collaborator Author

I will add some on Sunday. You can review them on Monday or whenever you have time.

Just to confirm, this is the directory of those codes, right?

Yes that is the directory. Thanks!

sunayana added a commit to sunayana/WRI_WellBeing_Data_Layer that referenced this issue May 3, 2021
 cmougan#10 : Adds documentation for module osm_data_extraction.
sunayana added a commit to sunayana/WRI_WellBeing_Data_Layer that referenced this issue May 3, 2021
sunayana added a commit that referenced this issue May 3, 2021
 #10, #20 Adds information for command line app for night lights to R…
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

3 participants