Giter Site home page Giter Site logo

MEX documentation about gld HOT 9 CLOSED

worldbank avatar worldbank commented on August 25, 2024
MEX documentation

from gld.

Comments (9)

gronert-m avatar gronert-m commented on August 25, 2024 1

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

from gld.

gronert-m avatar gronert-m commented on August 25, 2024 1

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

from gld.

alexandraqn avatar alexandraqn commented on August 25, 2024

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.

from gld.

gronert-m avatar gronert-m commented on August 25, 2024

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.

from gld.

alexandraqn avatar alexandraqn commented on August 25, 2024

@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.

from gld.

alexandraqn avatar alexandraqn commented on August 25, 2024

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.

from gld.

alexandraqn avatar alexandraqn commented on August 25, 2024

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

from gld.

gronert-m avatar gronert-m commented on August 25, 2024

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.

from gld.

alexandraqn avatar alexandraqn commented on August 25, 2024

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

from gld.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.