{"id":3378,"date":"2019-05-31T18:41:49","date_gmt":"2019-05-31T18:41:49","guid":{"rendered":"https:\/\/notebooks.dataone.org\/?p=3378"},"modified":"2019-05-31T18:41:49","modified_gmt":"2019-05-31T18:41:49","slug":"week-2-primary-steps-and-first-attempts-at-creating-with-markdown","status":"publish","type":"post","link":"https:\/\/notebooks.dataone.org\/education-enhancement\/week-2-primary-steps-and-first-attempts-at-creating-with-markdown\/","title":{"rendered":"Week 2 – Primary Steps and First Attempts at Creating with Markdown"},"content":{"rendered":"\n
Hello, World!<\/p>\n\n\n\n
\tThis week I had a great time exploring the DataONE GitHub repository and starting on the technical tutorial. To reiterate, the main goal for Project 1 is to create a tutorial which shows how to contribute educational materials to DataONE\u2019s Data Management Skillbuilding Hub. The tutorial would ideally be easy to follow and easily understood by people unfamiliar with coding and GitHub. <\/p>\n\n\n\n
Primary Steps<\/strong><\/p>\n\n\n\n In a discussion with my mentors and myself, we agreed that the first issue to tackle would be to define the \u201cprimary steps\u201d. These are the steps that all contributors need to complete in order to submit to the Skillbuilding Hub, regardless of what format their submission takes on. For example, the type of materials currently hosted by DataONE include markdown files, PDF\u2019s, and videos.<\/p>\n\n\n\n In order to submit any of these things, the contributor must be able to:<\/p>\n\n\n\n (1) Fork DataONE\u2019s Education Repository to their own online GitHub account, <\/p>\n\n\n\n (2) Commit a new markdown ( .md ) file which includes frontmatter<\/em> written in YAML (\u201cYet Another Markup Language\u201d<\/em>),<\/p>\n\n\n\n (3) Submit educational materials on data management, and <\/p>\n\n\n\n (4) Submit a pull request to the DataONE master repository to accept the new material It seems like a lot to ask of someone who has never used GitHub before! <\/p>\n\n\n\n On the contrary, it was actually very easy to learn. I, myself, have never used GitHub to work on a project before, and with some basic guidance, the learning curve was far less daunting. The goal of my tutorial is to provide that guidance!<\/p>\n\n\n\n Creating the Tutorial in Markdown<\/strong><\/p>\n\n\n\n \t<\/strong>I was very grateful to find that Markdown is extremely easy to write in! Markdown is a lightweight markup language with plain text formatting that makes your code easy to read, and easy to write. Markdown is used heavily by GitHub.<\/p>\n\n\n\n <\/p>\n\n\n\n Here\u2019s a preliminary look at my tutorial. I was able to learn fairly quickly how to format text, create dropdowns, and embed images.
<\/p>\n\n\n\n
<\/p>\n\n\n\n