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

MEX documentation #92

Closed
alexandraqn opened this issue Aug 5, 2021 · 9 comments
Closed

MEX documentation #92

alexandraqn opened this issue Aug 5, 2021 · 9 comments
Assignees
Labels
documentation Improvements or additions to documentation MEX

Comments

@alexandraqn
Copy link
Contributor

Hi @gronert-m ,

I just finished a very brief summary of the ENOE survey questionnaires. In particular, I focused on the short and extended versions of the questionnaires.

The link is here: https://github.com/worldbank/gld/blob/develop-merge/Support/Country%20Survey%20Details/MEX/ENOE/versions.md

I would be happy to hear if you agree with the content. Please, feel free to make comments on the file itself if that suits you better.

-Alexandra

@alexandraqn alexandraqn added documentation Improvements or additions to documentation MEX labels Aug 5, 2021
@gronert-m
Copy link
Contributor

Hi Alex,

Thanks for this. I have finally finished the document on the correspondence of national occupation codes and ISCO and I kindly ask you to read it and comment on it (as well as on the NAICS to ISIC one).

In addition, I changed the folder that contained the images and called it "utilities". This is so it makes sense that it contains more than images. I put your version.Rmd file in there, too. The regular version.md is still where it was and works without needing the other file.

On to the document at hand. My first comment would be to change the filename to something that gives the reader a bit of info. The user will enter the folder trying to find context information and has no idea what we have written. All they see at this point is the file name. While, once they click on it, they will have a full document with a clear title, we should try to make their live easier from the get-go. Since this is more of an introductory text and should be read before the other two, one possible simple option would be enoe-intro.md.

The second comment is on structure. You currently have two titles at the same level (technically two, one with the ==== underscore and the other using # but they end up being largely the same size. I think there should be just one.

Finally, I would rework to streamline a bit the structure. One proposal from me would be:

  • How ENOE works (it is quarterly survey with two different types of questionnaires, what are they)
  • How ENOE has changed
    • Changes in when what kind of survey is used (*details below)
    • Changes of each questionnaire type over time
  • What information to use
    • Option A: annualize all quarters, use only basic questionnaire
    • Option B: use Q1 as most often extended questionnaire most often in Q1
    • What choice was made, why, what info is lost (e.g., 2007, 2008 not using extended questionnaire)
  • Where to get more information (links to where to find more -> links from INEGI)

(*) I recommend adding the table from this INEGI document which may be a good file to link to in the final point on more info.
image

@alexandraqn
Copy link
Contributor Author

Dear @gronert-m ,
I want to thank you for the comments and I would like to know if you can take a look at the newer version of the introduction to the documentation. I tried to keep it concise but I understand that I still need to perhaps improve the language. Here it is : https://github.com/worldbank/gld/blob/develop-merge/Support/Country%20Survey%20Details/MEX/ENOE/ENOE-Introduction.md

I have not yet checked the post you wrote, I will do that as soon as I am done with this post. and I will provide comments accordingly.

@gronert-m
Copy link
Contributor

Hi @alexandraqn,

I finished writing an intro on the Employment and Unemployment Survey for India.

Having written this, I would request to add to your ENOE text two small points. One on providing the link to the Microdata (i.e., let people know where the data can be downloaded) and one on the significance level (it is in the subnatidsurvey in the harmonized data, but you can give some more context, for example that it also has municipalities, and the number of significant municipalities has increased over the years).

Finally, I would request you give some context to the list of links. Say what each one does. So the first is the general documentation site of ENOE. The third is the interviewer manual so the text should be something like:

The INEGI compiled comprehensive information on the questionnaires and the survey in general. The overall documentation site on ENOE can be found here. The (Spanish language) manual on ENOE methods and procedures is available here, while...

That way people know what they are going to get before they click on the link.

@alexandraqn
Copy link
Contributor Author

@gronert-m After reading your India introduction, and I think it looks great. I wonder if it would make sense to sit down and discuss our thoughts on the structure of the introduction to agree on titles, subtitles and content so that it is uniform across countries. Tomorrow will be a great platform to speak about this. Let me know your thoughts.

@gronert-m
Copy link
Contributor

@alexandraqn I think that is a great idea! I will add it to the agenda for today.

@alexandraqn
Copy link
Contributor Author

Hi @gronert-m,

This is the most updated version (https://github.com/worldbank/gld/blob/develop-merge/Support/Country%20Survey%20Details/MEX/ENOE/ENOE-Introduction.md) of the MEX documentation, following some of the guidelines we agreed last Friday. Please, let me know your comments.

@alexandraqn
Copy link
Contributor Author

Hi @gronert-m ,
Thanks very much for all the comments and suggestions. I finished the documentation as per the guidelines you sent us.
You can find it here ( https://github.com/worldbank/gld/blob/develop-merge/Support/Country%20Survey%20Details/MEX/ENOE/1.%20Introduction%20to%20ENOE.md) , let me know if you have any comments, I am happy to improve as required.
Best,
Alexandra

@gronert-m
Copy link
Contributor

Hi @alexandraqn ,

Thanks for updating this. I have made a small change to the section on the geographic significance level. I also had a few small comments.

The first is on the What is the sampling procedure? section. You write:

The ENOE uses a stratified two-stage design. The ENOE introduction provides ample detail on the breakdown and goals (see webpage *Encuesta Nacional de Ocupación y Empleo* under the ["recent version"](https://www.inegi.org.mx/programas/enoe/15ymas/) outlines the sampling procedure as:

However, I cannot see this recent version section you speak of. What I propose is to take a screenshot of it. I can show you how to include images into the text. That makes it easier for readers to find the information.

The second on the The ENOE sub-section under Other Noteworthy Aspects. This is no longer needed as it is in the first part.

Finally, under the ISCO Mapping (MEX) sub-section, it talks of the choice in quarter, which I think you covered under Information used in the GLD harmonization so I think that is also redundant.

@alexandraqn
Copy link
Contributor Author

alexandraqn commented Sep 22, 2021

Hi @gronert-m ,
Thanks, you did help me before on the issue of the images. So what I did is to include three images (steps) to access the information. Let me know if that is ok.
I also did the other changes as requested (I did agree with them).
The link here : https://github.com/worldbank/gld/blob/develop-merge/Support/Country%20Survey%20Details/MEX/ENOE/1.%20Introduction%20to%20ENOE.md
Thanks,
Alexandra

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 MEX
Projects
None yet
Development

No branches or pull requests

2 participants