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

Copyediting #22

Merged
merged 4 commits into from Mar 5, 2019

Conversation

Projects
None yet
3 participants
@ruebot
Copy link
Member

ruebot commented Mar 5, 2019

Close read of text and comments. I'll start with the example notebook, and move on to the other.

ruebot added some commits Mar 5, 2019

" :param by: \"all\", \"domain\" or \"year\" the output to return\n",
" :param minline: the minimum size of a line to be included in the output\n",
" :param by: \"all\", \"domain\" or \"year\" the output to return.\n",
" :param minline: the minimum size of a line to be included in the output.\n",
" :return: [(year/domain, text)] or [text] depending on by\n",

This comment has been minimized.

@ruebot

ruebot Mar 5, 2019

Author Member

@greebie the return comment here seems to be missing something. What should it read?

This comment has been minimized.

@greebie

greebie Mar 5, 2019

Collaborator

Maybe :return: [({year or domain}, textString)] if by is 'domain' or 'year', otherwise [textString]\n is more clear - it is also possible to include the type using :rtype: but I don't think that is too necessary.

@ruebot ruebot referenced this pull request Mar 5, 2019

Closed

Example collection #13

@greebie

greebie approved these changes Mar 5, 2019

"# characters to show per text file in output. Larger numbers will results in more\n",
"# text showing in output\n",
"# Characters to show per text file in output.\n",
"# Larger numbers will results in more text showing in output.\n",

This comment has been minimized.

@ianmilligan1

ianmilligan1 Mar 5, 2019

Member

"will results" -> "will result"

"# If you have a large file but want to sample the file more broadly, you\n",
"# can increase this value skip to every Nth line.\n",
"# If you have a large file but want to sample the file more broadly.\n",
"# You can increase this value skip to every Nth line.\n",
"RESULTS_STEP = 5\n",

This comment has been minimized.

@greebie

greebie Mar 5, 2019

Collaborator

I wonder if RESULTS_STEP should be changed to 1 for the default example? This var (plus RESULTS_START & RESULTS_LIMIT) is used basically so that we do not potato browsers. Right now, the analysis takes every 5th line starting from 0 and going to 2500, for a total of 500 lines. Alternately, we could keep RESULTS_STEP the same, and increase RESULTS_LIMIT to get more results.

"def write_output (stdout, results):\n",
" \"\"\" Writes results to file.\n",
" \n",
" :param stdout: Filepath for file\n",
" :param results: A list of results.\n",
" :return: Nothing\"\"\"\n",
" :return: Nothing\n",

This comment has been minimized.

@greebie

greebie Mar 5, 2019

Collaborator

:return: None\n

is the correct pydoc response here.

"mapping = {x[0]: x[1] for x in graph.nodes('label')}\n",
"\n",
"# Use Archive Unleashed Clouds Positions (saves on load time)\n",
"# Use Archive Unleashed Clouds Positions (saves on load time).\n",

This comment has been minimized.

@greebie

greebie Mar 5, 2019

Collaborator

Positions == positions.

"mapping = {x[0]: x[1] for x in neigh.nodes('label')}\n",
"\n",
"# Use Archive Unleashed Clouds Positions (saves on load time)\n",
"# Use Archive Unleashed Clouds Positions (saves on load time).\n",

This comment has been minimized.

@greebie

greebie Mar 5, 2019

Collaborator

Positions == positions

@ruebot

This comment has been minimized.

Copy link
Member Author

ruebot commented Mar 5, 2019

If we're good with the review commit, I'll move on to the other notebook. Then get the other dataset in other PR.

@greebie

greebie approved these changes Mar 5, 2019

@greebie

This comment has been minimized.

Copy link
Collaborator

greebie commented Mar 5, 2019

changes lgtm.

@ruebot ruebot marked this pull request as ready for review Mar 5, 2019

@ruebot

This comment has been minimized.

Copy link
Member Author

ruebot commented Mar 5, 2019

Both notebooks are added now. Let me know if there are any issues. If there are none, commit message should just be:

Title: Copyedit and clean-up comments. (#22)

@ianmilligan1 ianmilligan1 merged commit 1135914 into master Mar 5, 2019

1 check passed

ci/dockercloud Your tests passed in Docker Cloud
Details

@ianmilligan1 ianmilligan1 deleted the copyediting branch Mar 5, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.