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

All chapters: organizational cleanup #473

Merged
merged 65 commits into from
Aug 5, 2020
Merged

All chapters: organizational cleanup #473

merged 65 commits into from
Aug 5, 2020

Conversation

bbdaniels
Copy link
Collaborator

@bbdaniels bbdaniels commented Jul 8, 2020

This PR will include:

  • Updates of book title
  • Updates of chapter names and file names
  • Update of Introduction and appropriate references to chapters/content location
  • Take decision on inclusion of "Research Design" appendix (old Ch3): program-evaluation.pdf
  • Supersede and close D4di manuscript re org #439

Close the following:

@bbdaniels bbdaniels changed the base branch from master to develop July 8, 2020 17:27
@bbdaniels bbdaniels marked this pull request as draft July 8, 2020 17:27
@bbdaniels bbdaniels self-assigned this Jul 13, 2020
@bbdaniels
Copy link
Collaborator Author

bbdaniels commented Jul 21, 2020

Opening this for review from all.

@kbjarkefur - I noticed that even though I am now able to compile the manuscript I still am not getting the commit hash:

Screen Shot 2020-07-21 at 3 04 43 PM

@bbdaniels bbdaniels marked this pull request as ready for review July 21, 2020 19:05
@bbdaniels bbdaniels added the Read me! I'm ready for review! label Jul 21, 2020
Copy link
Collaborator

@luizaandrade luizaandrade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, Ben!
Minor comments added inline :)

chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
bbdaniels and others added 4 commits July 22, 2020 11:48
Co-authored-by: Luiza Andrade <[email protected]>
Co-authored-by: Luiza Andrade <[email protected]>
Co-authored-by: Luiza Andrade <[email protected]>
Co-authored-by: Luiza Andrade <[email protected]>
Copy link
Contributor

@mariaruth mariaruth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good, but we still need to address Arianna's comments regarding the intro:

  • Comment: "this is four author guide that gives no credit to the work of everybody who contributed to DIME and DIME Analytics. I am worried about this. The background should be DIME and why we established DIME Analytics and what DIME Analytics produced as a result of working on DIME projects... It will have to explain what DIME does (either without copying and pasting or by using quotes and referring to the original documents). You need to include stats on the size of our data efforts, the size of our FC and RA pools, and how this motivated the establishment of DIME analytics and how DIME analytics capitalized on the knowledge generated in the process of doing research and field work. "

  • revise the DIME overview paragraph to reflect the above: cite the annual report, make sure that numbers mentioned in this paragraph align with what's there, and that the text is not an exact copy-paste. also the IDEA handbook chapter might be useful to cite. Link to the text is here, the chapter is forthcoming but citeable: https://worldbankgroup-my.sharepoint.com/:w:/g/personal/mjones5_worldbank_org/EWtukZMQT9JNhS9ykWniNIoB5GN1kEt84IqNQJ3_m70gkA?e=dG5FZr.

  • add more to the paragraph describing DIME Analytics. the IDEA handbook chapter is a possible source for that. Arianna's comment "The intro should also give an overview of the transformation in expectations from the development economics profession and how this created a different institutional framework for us to work in and contribute to. Separating what was done by others e.g. registries, and what our contribution has been, e.g. proper protocols for reproducibility, is very important. None of our contribution comes out."

  • still need to address Arianna's comment: "The introduction should have a clear motivation of why data and not only research design is important for generating credible evidence. Here you need to make reference to actual research on the perils of poor data on research conclusions. "

  • the section on good code seems a little out of place with the flow of the rest of the introduction. i wonder if it still belongs here? i could also see it perhaps moving to chapter 2. but i don't feel strongly about that.

chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/conclusion.tex Show resolved Hide resolved
chapters/conclusion.tex Show resolved Hide resolved
Copy link
Contributor

@mariaruth mariaruth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! just a few more comments in line, mostly minor

chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
While is often \textit{possible} to perform nearly all the relevant tasks
through an interactive user interface or even through software such as Excel,
this practice is strongly advised against.
In the context of statistical analysis, this approach is widely accepted.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

widely accepted? increasingly perhaps, with pressure from journals ...

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe this is not clear, it's meant to say that "everyone agrees analysis work should be coded" in contrast to, say, data work. does that make sense?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah, that does make sense. it wasn't clear.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

chapters/0-introduction.tex Outdated Show resolved Hide resolved
chapters/0-introduction.tex Outdated Show resolved Hide resolved
bbdaniels and others added 2 commits August 5, 2020 11:04
Co-authored-by: Kristoffer Bjärkefur <[email protected]>
Co-authored-by: Kristoffer Bjärkefur <[email protected]>
@bbdaniels bbdaniels merged commit aa02ce3 into develop Aug 5, 2020
@bbdaniels bbdaniels deleted the bbd-org-cleanup branch August 5, 2020 15:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Read me! I'm ready for review!
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants