Add a join the lab section and reorganize some sections

index.md

@@ -36,6 +36,14 @@ We are also champions of **open science** and **reproducible research**.
 All of our teaching and research efforts are symbiotic with the development of
 **open source software** for geoscience.
 
+<div class="callout">
+
+**Want to work with us?**
+Have a look at the {{ macros.page_link("manual/index", page, site) }}, which
+outlines our core principles as scientists and how we operate as a team.
+
+</div>
+
 {{ macros.figure("images/research-highlights.jpg", caption="Example research outputs. <strong>Top left:</strong> automatic detection of anomalies in magnetic microscopy data. <strong>Top right:</strong> compilation of airborne magnetic data for Antarctica. <strong>Bottom left:</strong> a tesseroid (spherical prism) discretized with our adaptive algorithm for gravity modeling. <strong>Bottom right:</strong> estimated Moho depth for South America from gravity data (left) and the misfit with seismological estimates (right).", alt="Figure with four panels. Top left is a map showing red and blue blobs and black squares surrounding each one. Top right is a map of Antarctica with red and blue points overlaid covering a large portion of the continent. Bottom left is a spherical 8-sided prism on top of the globe with white lines showing how it's broken up irregularly. Bottom right are two maps of South America, one colored green to yellow representing the Moho depth, larger around the Andes and smaller in towards the Atlantic coast, the other has scattered colored dots showing larger differences in the Andes and smaller elsewhere." ) }}
 
 

manual/coc.md

@@ -53,6 +53,6 @@ or the central
 ## Credit
 
 This Code of Conduct was adapted from
-[confcodeofconduct.com](https://confcodeofconduct.com), licensed
+[confcodeofconduct.com](https://confcodeofconduct.com), which is licensed
 [CC-BY](https://creativecommons.org/licenses/by/3.0/deed.en).
 

manual/computing.md

@@ -5,8 +5,8 @@ title: Computer setup
 <div class="lead">
 
 Most projects developed in the lab will require you to have
-git, a terminal, and Python properly setup on your computer.
-Below are some instructions on how to do this.
+a computer with git, a terminal, and Python properly setup.
+Below are some **instructions** on how to get started.
 
 </div>
 

manual/getting-started.md

@@ -0,0 +1,71 @@
+---
+title: Getting started
+---
+
+{% import "macros.html" as macros %}
+
+<div class="lead">
+
+When you first join the lab (ideally within the first few weeks), you will have
+a **meeting with Leo** to introduce lab protocols, set expectations, add you to
+communication channels, etc. It's also a good idea to read the lists below for
+tips on what you should do and how to get accommodated in São Paulo.
+
+</div>
+
+## Things to do when joining the lab
+
+1. Read the [lab Code of Conduct][coc] carefully.
+1. Go over the rest of lab manual.
+1. Get the password for the lab (room A-204) and a tour of what it offers.
+1. Get a place to work and a computer in an office (for graduate students only)
+   or the computer lab.
+1. Create an account on the chat room (see {{ macros.page_link("manual/communication", page, site) }}) and send Leo a message (`@leouieda`) so he can add you to the `CompGeoLab` channel.
+1. Install the [Mattermost app][mattermost]. You don't need to have it on your phone if you prefer not to, but at least install it on your computer.
+1. Create an account on [GitHub](https://github.com/). Make sure your username is something that you would be OK putting on a publication or your CV (so nothing offensive, please).
+1. Send Leo a message with your GitHub username so he can add you to the [lab GitHub organization][gh].
+1. Study the [Software Carpentry][swc] lessons on Version Control with Git, Python, and the Unix Shell. They will be crucial for your project. Go over Git and the Unix Shell first.
+1. Explore the GitHub organization to see what the group is working on.
+1. Add yourself to the website (if you want). See the [Contributing Guide][website-contrib] for instructions.
+1. Read the main references for your project (if Leo doesn't send them to you, please remind him).
+1. Go and start making something brilliant!
+
+## Things Leo has to do to get you setup
+
+1. Introduce the [lab website][website] and [GitHub organization][gh] where all
+   our research projects live.
+1. Go over this manual.
+1. Send a message to the group introducing the new member.
+1. Add them to the [lab GitHub organization][gh].
+1. Send the main papers related to the new member's project.
+1. Add them to the lab calendar and recurring events (lab meetings, etc).
+
+## Tips and tricks for studying at USP
+
+1. There are [free buses](https://puspcb.usp.br/uso-do-campus/transportes-3/)
+   that go from the Butantã metro station (yellow line) to various parts of
+   campus. You'll first need to get a [BUSP card](https://www.puspc.usp.br/bilhete-usp-busp/)
+   card to ride for free. But the buses also take regular cards (but will
+   charge you). Beware that buses get very crowded during term time at peak
+   hours (7-9 and 17-19).
+1. If you live close to campus, riding a bike is usually the fastest way to get
+   to IAG. [Jonny Bike](https://www.google.com/maps/place/Jonny+Bike/@-23.5706632,-46.7085456,20.25z/data=!4m6!3m5!1s0x94ce57ab330d630d:0x84c90eb3d93746e1!8m2!3d-23.5708333!4d-46.7088889!16s%2Fg%2F1pv5xbkhp?entry=ttu&g_ep=EgoyMDI1MDEyMS4wIKXMDSoASAFQAw%3D%3D)
+   is a pretty good bike shop close to the subway station.
+1. Make sure you have a [Bilhete Único](https://bilheteunico.sptrans.com.br/)
+   to use public transport in São Paulo. Undergrad and graduate students should
+   be eligible for a student card once enrolled but if you're new to São Paulo
+   you should get a regular one as soon as you arrive to avoid paying more than
+   you should for transport.
+1. There are many apartments for rent close to the Butantã subway station and
+   it's very good neighborhood. But it's also more expensive. Places further
+   along Av. Corifeu de Azevedo Marques (Vila Indiana, Vila Universitária, Vila
+   Butantã) and still offer good transport options to IAG. If living in Vila
+   Indiana, it may be a good idea to get an electric bike since there is
+   a steep hill to go anywhere.
+
+[coc]: {{ site["manual/coc"].path|relative_to(page.path) }}
+[website-contrib]: https://github.com/compgeolab/website/blob/main/CONTRIBUTING.md
+[website]: https://www.compgeolab.org
+[swc]: https://software-carpentry.org/lessons/
+[gh]: https://github.com/compgeolab/
+[mattermost]: https://mattermost.com/apps/

manual/health.md

@@ -10,7 +10,7 @@ No project, paper, grant, or collaboration is more important than that.
 
 </div>
 
-## At Universidade de São Paulo
+## Resources in São Paulo
 
 * [Hospital Universitário](https://www.hu.usp.br/): The campus hospital is
   excellent, has a walk-in service and provides free medical for the university
@@ -23,9 +23,9 @@ No project, paper, grant, or collaboration is more important than that.
 * [Ministério da Saúde - Suicídio (Prevenção)](https://www.gov.br/saude/pt-br/assuntos/saude-de-a-a-z/s/suicidio-prevencao):
   The ministry of health website has resources for suicide prevention and how
   to get help with mental health issues.
-* [Centro de Valorização da Vida](https://cvv.org.br/): Offers a 24h help line by phone, chat, email, and in-person (the closest center to campus is in [Pinheiros](https://www.google.com/maps/place/R.+Cerro+Cor%C3%A1,+792+-+21+-+Vila+Romana,+S%C3%A3o+Paulo+-+SP,+05061-100/@-23.5401302,-46.7049922,19.29z/data=!4m5!3m4!1s0x94ce57d3e451c08b:0x28663176a7d2cad5!8m2!3d-23.5397673!4d-46.7047116?entry=ttu)). 
+* [Centro de Valorização da Vida](https://cvv.org.br/): Offers a 24h help line by phone, chat, email, and in-person (the closest center to campus is in [Pinheiros](https://www.google.com/maps/place/R.+Cerro+Cor%C3%A1,+792+-+21+-+Vila+Romana,+S%C3%A3o+Paulo+-+SP,+05061-100/@-23.5401302,-46.7049922,19.29z/data=!4m5!3m4!1s0x94ce57d3e451c08b:0x28663176a7d2cad5!8m2!3d-23.5397673!4d-46.7047116?entry=ttu)).
 
-## At University of Liverpool
+## Resources in Liverpool
 
 * [Student Services](https://www.liverpool.ac.uk/studentsupport/): General
   information and links to the different types of support offered to university

manual/index.md

@@ -2,13 +2,14 @@
 title: Lab manual
 toc_table:
   - manual/index
-  - manual/coc
-  - manual/induction
   - manual/open-science
-  - manual/expectations
-  - manual/health
   - manual/authorship
+  - manual/join
+  - manual/getting-started
+  - manual/expectations
   - manual/communication
+  - manual/health
+  - manual/coc
   - manual/software
   - manual/computing
   - manual/resources
@@ -40,5 +41,7 @@ read {{ macros.page_link("manual/open-science", page, site) }} and
 {{ macros.page_link("manual/authorship", page, site) }}.
 These sections outline our core principles as scientists and it's important
 that you are aware of and agree with these principles to a large extent.
+See {{ macros.page_link("manual/join", page, site) }} for opportunities for
+students or postdoc.
 
 </div>

manual/index.yml

@@ -2,10 +2,10 @@ template: manual.html
 license: |
   This manual is based on the excellent
   <a target="_blank" href="https://github.com/lab-carpentry">Lab Carpentry</a>
-  blueprints, with material adapted from the 
-  <a target="_blank" href="http://ivory.idyll.org/lab/">Data Intensive Biology Lab</a> 
-  and the 
+  blueprints, with material adapted from the
+  <a target="_blank" href="http://ivory.idyll.org/lab/">Data Intensive Biology Lab</a>
+  and the
   <a target="_blank" href="https://data-exp-lab.github.io/">Data Exploration Lab</a>.
   The manual contents are available under the
-  <a target="_blank" href="https://creativecommons.org/licenses/by/4.0">Creative 
+  <a target="_blank" href="https://creativecommons.org/licenses/by/4.0">Creative
   Commons Attribution 4.0 International (CC BY 4.0)</a> license.

manual/join.md

@@ -0,0 +1,83 @@
+---
+title: How to join the lab
+---
+
+{% import "macros.html" as macros %}
+
+<div class="lead">
+
+The lab is based primarily at {{ config.location.school }} in the Butantã
+campus of {{ config.location.university }}.
+See below for opportunities to join the lab.
+
+</div>
+
+## General guidelines
+
+Before applying to join the lab or starting a collaboration, please
+read {{ macros.page_link("manual/open-science", page, site) }} and
+{{ macros.page_link("manual/authorship", page, site) }}.
+These sections outline our core principles as scientists and it's important
+that you are aware of and agree with these principles to a large extent.
+
+If you feel like we would be a good match, the best thing is to **contact Leo
+first** to see if he is able to take on more students and postdocs.
+We aim to foster a small and healthy research group, where everyone has the
+time and support they need to thrive.
+Unfortunately, this means that sometimes we cannot take on new members.
+
+When writing to Leo to inquire about opportunities, please mention **specific
+examples** of things you'd like to work on. What are your interests? What about
+the group made you want to join? What are your career goals? You don't need to
+have a concrete idea but it helps to demonstrate that you've looked at our
+research and have given this some thought.
+
+## Undergraduate students
+
+We're interested in undergraduate students who want to pursue research in any
+of our research themes, including open-source software development.
+Students from any degree programme are welcome as long as they have a basic
+background in calculus, physics, and computer programming.
+**The most important characteristic we're looking for is curiosity and
+motivation to learn independently**.
+If this is you, then get in touch with Leo!
+
+There are several opportunities for scientific initiation scholarships which we
+can pursue (PUB, PIBIC, FAPESP). In general, students first start working
+a small amount of hours on a volunteer basis to see if there is a good match
+with the lab before applying for a scholarship.
+
+## Graduate students
+
+Applications are handled by the
+[Geophysics graduate program](https://www.iag.usp.br/pos-graduacao/geofisica)
+at IAG.
+However, please **speak with Leo before applying** if you're interested in
+joining the lab.
+This is a requirement for PhD students and highly encouraged for MSc students.
+While MSc students can apply without having a supervisor, there is no guarantee
+that the lab will be able to accommodate you even if you are offered a place in
+the programme.
+
+The programme has a good number of CAPES **scholarships** for both **national
+and international students**.
+There is no relocation funding so you'll have to make your way to São Paulo
+using your own funds.
+We can also apply for [FAPESP scholarships](https://fapesp.br/bolsas), which
+pay significantly more but are harder to get.
+If this is something you want to do, then please let Leo know and we should
+apply as soon as possible (even before you are officially accepted into the
+graduate programme).
+
+## Postdocs
+
+FAPESP has the [best scholarships](https://fapesp.br/bolsas/pd) for postdocs
+and accepts national and international applicants.
+Their scholarships are very generous and are usually tax-free in Brazil.
+There are other scholarships available from time to time so it's good to check
+with Leo if there is anything that would suite you.
+
+There is no entry requirements or selection process in the department for
+postdocs. So it's mostly a matter of finding funding for a scholarship.
+That said, postdocs are **expected to be independent researchers** and bring
+their own project ideas.