diff --git a/404.html b/404.html index 73625a4..8304969 100644 --- a/404.html +++ b/404.html @@ -4,13 +4,13 @@ Page Not Found | Intern Onboarding Guide - +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- + \ No newline at end of file diff --git a/about/index.html b/about/index.html index d9389f1..a2355c3 100644 --- a/about/index.html +++ b/about/index.html @@ -4,13 +4,13 @@ 🍃 About the Guide | Intern Onboarding Guide - +
Skip to main content

🍃 About the Guide

This guide serves as a reference for new interns at datHere.

⚡ Quick links!​

🔍 Found a mistake in the guide?​

Feel free to contribute to this site by clicking the "Edit this page" button at the bottom of any page on the guide to make a PR on our GitHub repository.

It helps keeping content up to date and accurate for future interns and for your own reference! 🌌

- + \ No newline at end of file diff --git a/assets/js/095073fd.5bfeb994.js b/assets/js/095073fd.fea4e386.js similarity index 97% rename from assets/js/095073fd.5bfeb994.js rename to assets/js/095073fd.fea4e386.js index 85205c8..f2c4266 100644 --- a/assets/js/095073fd.5bfeb994.js +++ b/assets/js/095073fd.fea4e386.js @@ -1 +1 @@ -"use strict";(self.webpackChunkde_intern_tutorial=self.webpackChunkde_intern_tutorial||[]).push([[920],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>m});var a=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var u=a.createContext({}),l=function(e){var t=a.useContext(u),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=l(e.components);return a.createElement(u.Provider,{value:t},e.children)},p="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},y=a.forwardRef((function(e,t){var n=e.components,o=e.mdxType,r=e.originalType,u=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),p=l(n),y=o,m=p["".concat(u,".").concat(y)]||p[y]||c[y]||r;return n?a.createElement(m,i(i({ref:t},d),{},{components:n})):a.createElement(m,i({ref:t},d))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=n.length,i=new Array(r);i[0]=y;var s={};for(var u in t)hasOwnProperty.call(t,u)&&(s[u]=t[u]);s.originalType=e,s[p]="string"==typeof e?e:o,i[1]=s;for(var l=2;l{n.r(t),n.d(t,{assets:()=>u,contentTitle:()=>i,default:()=>c,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var a=n(7462),o=(n(7294),n(3905));const r={sidebar_position:3},i="\u2615 Daily Standups",s={unversionedId:"technical-writing/daily-standups",id:"technical-writing/daily-standups",title:"\u2615 Daily Standups",description:"You'll often greet your workday with a standup meeting. This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing.",source:"@site/docs/technical-writing/daily-standups.md",sourceDirName:"technical-writing",slug:"/technical-writing/daily-standups",permalink:"/de-intern-guide/technical-writing/daily-standups",draft:!1,editUrl:"https://github.com/dathere/de-intern-guide/tree/main/docs/technical-writing/daily-standups.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"guideSidebar",previous:{title:"\ud83d\udcdd Markdown",permalink:"/de-intern-guide/technical-writing/markdown"},next:{title:"\ud83d\udef9 Kanban Boards",permalink:"/de-intern-guide/technical-writing/kanban-boards"}},u={},l=[{value:"\ud83c\udfc1 Before the Standup",id:"-before-the-standup",level:2},{value:"\ud83c\udfce During the Standup",id:"-during-the-standup",level:2},{value:"\ud83c\udfc6 After the Standup",id:"-after-the-standup",level:2},{value:"\ud83e\udde9 Daily Standup Notes Template",id:"-daily-standup-notes-template",level:2}],d={toc:l},p="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(p,(0,a.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"-daily-standups"},"\u2615 Daily Standups"),(0,o.kt)("p",null,"You'll often greet your workday with a ",(0,o.kt)("strong",{parentName:"p"},"standup meeting"),". This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing."),(0,o.kt)("p",null,"To stay on track on a daily basis, it can be very helpful to organize yourself before, during, and after this meeting."),(0,o.kt)("h2",{id:"-before-the-standup"},"\ud83c\udfc1 Before the Standup"),(0,o.kt)("p",null,"Try to write down the following before your standup meeting:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"\ud83c\udf89 What you've accomplished since the last standup meeting"),(0,o.kt)("li",{parentName:"ul"},"\ud83d\udee0 What you plan to continue working on or work on next"),(0,o.kt)("li",{parentName:"ul"},'\u274c "Blockers" you are facing, which are things that stop you from continuing work on a task or project'),(0,o.kt)("li",{parentName:"ul"},"\u2753 Questions you have for any team member (or in general) that you couldn't get answered over your team communication platform")),(0,o.kt)("h2",{id:"-during-the-standup"},"\ud83c\udfce During the Standup"),(0,o.kt)("p",null,"When it's your turn, cover the points you wrote down without going into too much extensive detail (as you should put any extra details in your notes or kanban board). Ask to setup a meeting with any team member you have questions for if you can't get them answered during the standup or if what you're working on requires more discussion and doesn't need the entire team's attention."),(0,o.kt)("p",null,"Also make sure to write down any new tasks or to-dos assigned to you during the standup. \ud83d\udcc3"),(0,o.kt)("h2",{id:"-after-the-standup"},"\ud83c\udfc6 After the Standup"),(0,o.kt)("p",null,"Review what you've written down and make sure you've answered all your questions and resolved any blockers. If you haven't, make sure to follow up with the appropriate team members. If you use a kanban board or any tracker for your tasks and projects, add any new tasks assigned to you to your board and update any notes or progress you've made on your tasks."),(0,o.kt)("p",null,"Now you have a good idea of what you need to do for the day. Get to work! \ud83d\udcbc"),(0,o.kt)("h2",{id:"-daily-standup-notes-template"},"\ud83e\udde9 Daily Standup Notes Template"),(0,o.kt)("p",null,"Here's a Markdown template you can use daily to keep track of your standup notes:"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-markdown"},"# \ud83d\udcc5 [Date] Daily Standup\n\n## \ud83c\udf89 Accomplished\n\n> What tasks you've completed or goals you've accomplished or made progress on.\n\n-\n\n## \ud83d\udee0 Working On\n\n> What you are currently working on or plan to start working on and how much progress you expect to make. Also when you complete or make progress on your tasks, write down what you've done for tomorrow's Accomplished section.\n\n-\n\n## \u274c Blockers\n\n> Problems you're facing that stop you from continuing work.\n\n-\n\n## \u2753 Questions\n\n> Any specific questions you have for any team member or in general. Make sure you write down the answers when you get them too.\n\n-\n\n## \ud83d\udcc3 Todo\n\n> Any new tasks assigned, meetings to setup, etc. that you may also add to your kanban board.\n\n- [ ]\n")),(0,o.kt)("p",null,"Personally I like to use ",(0,o.kt)("a",{parentName:"p",href:"https://obsidian.md/"},"Obsidian")," to keep track of my daily standup notes (especially with its ",(0,o.kt)("a",{parentName:"p",href:"https://help.obsidian.md/Plugins/Daily+notes"},"Daily Notes plugin"),"), but you can use any note-taking app you like."))}c.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkde_intern_tutorial=self.webpackChunkde_intern_tutorial||[]).push([[920],{3905:(e,t,n)=>{n.d(t,{Zo:()=>d,kt:()=>m});var a=n(7294);function o(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function r(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function i(e){for(var t=1;t=0||(o[n]=e[n]);return o}(e,t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(o[n]=e[n])}return o}var u=a.createContext({}),l=function(e){var t=a.useContext(u),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},d=function(e){var t=l(e.components);return a.createElement(u.Provider,{value:t},e.children)},p="mdxType",c={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},y=a.forwardRef((function(e,t){var n=e.components,o=e.mdxType,r=e.originalType,u=e.parentName,d=s(e,["components","mdxType","originalType","parentName"]),p=l(n),y=o,m=p["".concat(u,".").concat(y)]||p[y]||c[y]||r;return n?a.createElement(m,i(i({ref:t},d),{},{components:n})):a.createElement(m,i({ref:t},d))}));function m(e,t){var n=arguments,o=t&&t.mdxType;if("string"==typeof e||o){var r=n.length,i=new Array(r);i[0]=y;var s={};for(var u in t)hasOwnProperty.call(t,u)&&(s[u]=t[u]);s.originalType=e,s[p]="string"==typeof e?e:o,i[1]=s;for(var l=2;l{n.r(t),n.d(t,{assets:()=>u,contentTitle:()=>i,default:()=>c,frontMatter:()=>r,metadata:()=>s,toc:()=>l});var a=n(7462),o=(n(7294),n(3905));const r={sidebar_position:3},i="\u2615 Daily Standups",s={unversionedId:"technical-writing/daily-standups",id:"technical-writing/daily-standups",title:"\u2615 Daily Standups",description:"You'll often greet your workday with a standup meeting. This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing.",source:"@site/docs/technical-writing/daily-standups.md",sourceDirName:"technical-writing",slug:"/technical-writing/daily-standups",permalink:"/de-intern-guide/technical-writing/daily-standups",draft:!1,editUrl:"https://github.com/dathere/de-intern-guide/tree/main/docs/technical-writing/daily-standups.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"guideSidebar",previous:{title:"\ud83d\udcdd Markdown",permalink:"/de-intern-guide/technical-writing/markdown"},next:{title:"\ud83d\udef9 Kanban Boards",permalink:"/de-intern-guide/technical-writing/kanban-boards"}},u={},l=[{value:"\ud83c\udfc1 Before the Standup",id:"-before-the-standup",level:2},{value:"\ud83c\udfce During the Standup",id:"-during-the-standup",level:2},{value:"\ud83c\udfc6 After the Standup",id:"-after-the-standup",level:2},{value:"\ud83e\udde9 Daily Standup Notes Template",id:"-daily-standup-notes-template",level:2}],d={toc:l},p="wrapper";function c(e){let{components:t,...n}=e;return(0,o.kt)(p,(0,a.Z)({},d,n,{components:t,mdxType:"MDXLayout"}),(0,o.kt)("h1",{id:"-daily-standups"},"\u2615 Daily Standups"),(0,o.kt)("p",null,"You'll often greet your workday with a ",(0,o.kt)("strong",{parentName:"p"},"standup meeting"),". This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing."),(0,o.kt)("p",null,"To stay on track on a daily basis, it can be very helpful to organize yourself before, during, and after this meeting."),(0,o.kt)("h2",{id:"-before-the-standup"},"\ud83c\udfc1 Before the Standup"),(0,o.kt)("p",null,"Try to write down the following before your standup meeting:"),(0,o.kt)("ul",null,(0,o.kt)("li",{parentName:"ul"},"\ud83c\udf89 What you've accomplished since the last standup meeting"),(0,o.kt)("li",{parentName:"ul"},"\ud83d\udee0 What you plan to continue working on or work on next"),(0,o.kt)("li",{parentName:"ul"},'\u274c "Blockers" you are facing, which are things that stop you from continuing work on a task or project'),(0,o.kt)("li",{parentName:"ul"},"\u2753 Questions you have for any team member (or in general) that you couldn't get answered over your team communication platform")),(0,o.kt)("h2",{id:"-during-the-standup"},"\ud83c\udfce During the Standup"),(0,o.kt)("p",null,"When it's your turn, cover the points you wrote down without going into too much extensive detail (as you should put any extra details in your notes or kanban board). Ask to setup a meeting with any team member you have questions for if you can't get them answered during the standup or if what you're working on requires more discussion and doesn't need the entire team's attention."),(0,o.kt)("p",null,"Also make sure to write down any new tasks or to-dos assigned to you during the standup. \ud83d\udcc3"),(0,o.kt)("h2",{id:"-after-the-standup"},"\ud83c\udfc6 After the Standup"),(0,o.kt)("p",null,"Review what you've written down and make sure you've answered all your questions and resolved any blockers. If you haven't, make sure to follow up with the appropriate team members. If you use a kanban board or any tracker for your tasks and projects, add any new tasks assigned to you to your board and update any notes or progress you've made on your tasks."),(0,o.kt)("p",null,"Now you have a good idea of what you need to do for the day. Get to work! \ud83d\udcbc"),(0,o.kt)("h2",{id:"-daily-standup-notes-template"},"\ud83e\udde9 Daily Standup Notes Template"),(0,o.kt)("p",null,"Here's a Markdown template you can use daily to keep track of your standup notes:"),(0,o.kt)("pre",null,(0,o.kt)("code",{parentName:"pre",className:"language-markdown"},"# \ud83d\udcc5 [Date] Daily Standup\n\n## \ud83c\udf89 Accomplished\n\n> What tasks you've completed or goals you've accomplished or made progress on.\n\n-\n\n## \ud83d\udee0 Working On\n\n> What you are currently working on or plan to start working on and how much progress you expect to make. Also when you complete or make progress on your tasks, write down what you've done for tomorrow's Accomplished section.\n\n-\n\n## \u274c Blockers\n\n> Problems you're facing that stop you from continuing work.\n\n-\n\n## \u2753 Questions\n\n> Any specific questions you have for any team member or in general. Make sure you write down the answers when you get them too.\n\n-\n\n## \ud83d\udcc3 Todo\n\n> Any new tasks assigned, meetings to setup, etc. that you may also add to your kanban board.\n\n- [ ]\n")),(0,o.kt)("p",null,"Personally I like to use ",(0,o.kt)("a",{parentName:"p",href:"https://obsidian.md/"},"Obsidian")," to keep track of my daily standup notes (especially with its ",(0,o.kt)("a",{parentName:"p",href:"https://help.obsidian.md/Plugins/Daily+notes"},"Daily Notes plugin"),"), but you can use any note-taking app you like. Note that with Obsidian you may need to purchase a commercial use license in order to use Obsidian as your program. Another option is to use Visual Studio Code."))}c.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/0ab13595.4413885a.js b/assets/js/0ab13595.03cbfe8d.js similarity index 87% rename from assets/js/0ab13595.4413885a.js rename to assets/js/0ab13595.03cbfe8d.js index 8a0ada3..ed03962 100644 --- a/assets/js/0ab13595.4413885a.js +++ b/assets/js/0ab13595.03cbfe8d.js @@ -1 +1 @@ -"use strict";(self.webpackChunkde_intern_tutorial=self.webpackChunkde_intern_tutorial||[]).push([[617],{3905:(e,t,n)=>{n.d(t,{Zo:()=>s,kt:()=>w});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var d=r.createContext({}),c=function(e){var t=r.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},s=function(e){var t=c(e.components);return r.createElement(d.Provider,{value:t},e.children)},u="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,d=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),u=c(n),m=a,w=u["".concat(d,".").concat(m)]||u[m]||p[m]||i;return n?r.createElement(w,o(o({ref:t},s),{},{components:n})):r.createElement(w,o({ref:t},s))}));function w(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var l={};for(var d in t)hasOwnProperty.call(t,d)&&(l[d]=t[d]);l.originalType=e,l[u]="string"==typeof e?e:a,o[1]=l;for(var c=2;c{n.r(t),n.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>p,frontMatter:()=>i,metadata:()=>l,toc:()=>c});var r=n(7462),a=(n(7294),n(3905));const i={sidebar_position:2},o="\ud83d\udcdd Markdown",l={unversionedId:"technical-writing/markdown",id:"technical-writing/markdown",title:"\ud83d\udcdd Markdown",description:"Markdown is a markup language that is very useful for taking notes and writing documentation.",source:"@site/docs/technical-writing/markdown.md",sourceDirName:"technical-writing",slug:"/technical-writing/markdown",permalink:"/de-intern-guide/technical-writing/markdown",draft:!1,editUrl:"https://github.com/dathere/de-intern-guide/tree/main/docs/technical-writing/markdown.md",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"guideSidebar",previous:{title:"\ud83d\uddfa Technical Writing Overview",permalink:"/de-intern-guide/technical-writing/technical-writing-overview"},next:{title:"\u2615 Daily Standups",permalink:"/de-intern-guide/technical-writing/daily-standups"}},d={},c=[{value:"\ud83d\udcda Markdown Resources",id:"-markdown-resources",level:2},{value:"\ud83c\udfeb Learn Markdown",id:"-learn-markdown",level:3},{value:"\ud83d\udcd3 Markdown Editors",id:"-markdown-editors",level:3}],s={toc:c},u="wrapper";function p(e){let{components:t,...n}=e;return(0,a.kt)(u,(0,r.Z)({},s,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"-markdown"},"\ud83d\udcdd Markdown"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"Markdown")," is a markup language that is very useful for taking notes and writing documentation."),(0,a.kt)("p",null,"In fact, the page you're reading right now is built based on Markdown!"),(0,a.kt)("h2",{id:"-markdown-resources"},"\ud83d\udcda Markdown Resources"),(0,a.kt)("h3",{id:"-learn-markdown"},"\ud83c\udfeb Learn Markdown"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/"},"Markdown Guide")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/cheat-sheet/"},"Markdown Cheatsheet"))),(0,a.kt)("h3",{id:"-markdown-editors"},"\ud83d\udcd3 Markdown Editors"),(0,a.kt)("p",null,"Here are some Markdown editors you can use for taking notes:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://obsidian.md/"},"Obsidian")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.notion.so/"},"Notion"))),(0,a.kt)("admonition",{type:"note"},(0,a.kt)("p",{parentName:"admonition"},"These programs often have extra features that can be useful for taking notes, such as the ability to create kanban boards, embed images, and more. However, they do support Markdown. Also, you can instead make a new Markdown file in your favorite text editor like Visual Studio Code by saving a file with the ",(0,a.kt)("inlineCode",{parentName:"p"},".md")," extension.")))}p.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunkde_intern_tutorial=self.webpackChunkde_intern_tutorial||[]).push([[617],{3905:(e,t,n)=>{n.d(t,{Zo:()=>s,kt:()=>w});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var d=r.createContext({}),c=function(e){var t=r.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},s=function(e){var t=c(e.components);return r.createElement(d.Provider,{value:t},e.children)},u="mdxType",p={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,d=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),u=c(n),m=a,w=u["".concat(d,".").concat(m)]||u[m]||p[m]||i;return n?r.createElement(w,o(o({ref:t},s),{},{components:n})):r.createElement(w,o({ref:t},s))}));function w(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var l={};for(var d in t)hasOwnProperty.call(t,d)&&(l[d]=t[d]);l.originalType=e,l[u]="string"==typeof e?e:a,o[1]=l;for(var c=2;c{n.r(t),n.d(t,{assets:()=>d,contentTitle:()=>o,default:()=>p,frontMatter:()=>i,metadata:()=>l,toc:()=>c});var r=n(7462),a=(n(7294),n(3905));const i={sidebar_position:2},o="\ud83d\udcdd Markdown",l={unversionedId:"technical-writing/markdown",id:"technical-writing/markdown",title:"\ud83d\udcdd Markdown",description:"Markdown is a markup language that is very useful for taking notes and writing documentation.",source:"@site/docs/technical-writing/markdown.md",sourceDirName:"technical-writing",slug:"/technical-writing/markdown",permalink:"/de-intern-guide/technical-writing/markdown",draft:!1,editUrl:"https://github.com/dathere/de-intern-guide/tree/main/docs/technical-writing/markdown.md",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"guideSidebar",previous:{title:"\ud83d\uddfa Technical Writing Overview",permalink:"/de-intern-guide/technical-writing/technical-writing-overview"},next:{title:"\u2615 Daily Standups",permalink:"/de-intern-guide/technical-writing/daily-standups"}},d={},c=[{value:"\ud83d\udcda Markdown Resources",id:"-markdown-resources",level:2},{value:"\ud83c\udfeb Learn Markdown",id:"-learn-markdown",level:3},{value:"\ud83d\udcd3 Markdown Editors",id:"-markdown-editors",level:3}],s={toc:c},u="wrapper";function p(e){let{components:t,...n}=e;return(0,a.kt)(u,(0,r.Z)({},s,n,{components:t,mdxType:"MDXLayout"}),(0,a.kt)("h1",{id:"-markdown"},"\ud83d\udcdd Markdown"),(0,a.kt)("p",null,(0,a.kt)("strong",{parentName:"p"},"Markdown")," is a markup language that is very useful for taking notes and writing documentation."),(0,a.kt)("p",null,"In fact, the page you're reading right now is built based on Markdown!"),(0,a.kt)("h2",{id:"-markdown-resources"},"\ud83d\udcda Markdown Resources"),(0,a.kt)("h3",{id:"-learn-markdown"},"\ud83c\udfeb Learn Markdown"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/"},"Markdown Guide")),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.markdownguide.org/cheat-sheet/"},"Markdown Cheatsheet"))),(0,a.kt)("h3",{id:"-markdown-editors"},"\ud83d\udcd3 Markdown Editors"),(0,a.kt)("p",null,"Here are some Markdown editors you can use for taking notes:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://obsidian.md/"},"Obsidian")," (you may need to purchase a commercial license)"),(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("a",{parentName:"li",href:"https://www.notion.so/"},"Notion"))),(0,a.kt)("admonition",{type:"note"},(0,a.kt)("p",{parentName:"admonition"},"These programs often have extra features that can be useful for taking notes, such as the ability to create kanban boards, embed images, and more. However, they do support Markdown. Also, you can instead make a new Markdown file in your favorite text editor like Visual Studio Code by saving a file with the ",(0,a.kt)("inlineCode",{parentName:"p"},".md")," extension.")))}p.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/runtime~main.889cfb7d.js b/assets/js/runtime~main.e3144a13.js similarity index 90% rename from assets/js/runtime~main.889cfb7d.js rename to assets/js/runtime~main.e3144a13.js index 2f4bcb7..a7934e9 100644 --- a/assets/js/runtime~main.889cfb7d.js +++ b/assets/js/runtime~main.e3144a13.js @@ -1 +1 @@ -(()=>{"use strict";var e,t,r,a,o,n={},f={};function d(e){var t=f[e];if(void 0!==t)return t.exports;var r=f[e]={id:e,loaded:!1,exports:{}};return n[e].call(r.exports,r,r.exports,d),r.loaded=!0,r.exports}d.m=n,d.c=f,e=[],d.O=(t,r,a,o)=>{if(!r){var n=1/0;for(u=0;u=o)&&Object.keys(d.O).every((e=>d.O[e](r[i])))?r.splice(i--,1):(f=!1,o0&&e[u-1][2]>o;u--)e[u]=e[u-1];e[u]=[r,a,o]},d.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return d.d(t,{a:t}),t},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,d.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);d.r(o);var n={};t=t||[null,r({}),r([]),r(r)];for(var f=2&a&&e;"object"==typeof f&&!~t.indexOf(f);f=r(f))Object.getOwnPropertyNames(f).forEach((t=>n[t]=()=>e[t]));return n.default=()=>e,d.d(o,n),o},d.d=(e,t)=>{for(var r in t)d.o(t,r)&&!d.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},d.f={},d.e=e=>Promise.all(Object.keys(d.f).reduce(((t,r)=>(d.f[r](e,t),t)),[])),d.u=e=>"assets/js/"+({53:"935f2afb",85:"1f391b9e",117:"356a0ac6",119:"a3696a00",152:"18d4c4b8",206:"f8409a7e",241:"01232042",262:"e27ea86e",329:"a9ca83f8",405:"a9ea4256",414:"393be207",432:"321014e7",514:"1be78505",617:"0ab13595",627:"b51a1159",762:"73ae107a",764:"0f1f73a8",795:"0f0cf65e",798:"a53e4d49",817:"14eb3368",827:"010f034f",838:"5a2b65ac",904:"1d769a5c",918:"17896441",920:"095073fd",935:"7aa35b29",985:"f269bf4d"}[e]||e)+"."+{53:"ec4aa3da",85:"9cf78ad5",117:"14cf7ee2",119:"69839c27",152:"f4b1aff4",206:"cbf970c8",241:"9dc00bc5",262:"615cb4b9",329:"d40db704",405:"2a98d330",414:"1d2f2320",432:"a44e453a",455:"907a2712",514:"542f6b54",617:"4413885a",627:"701a27cd",762:"26e546de",764:"eaeaad6c",795:"eb7870ee",798:"7f7217ba",817:"56d64c00",827:"437add93",838:"f6bd3c5d",904:"fdd7684e",918:"e27ac847",920:"5bfeb994",935:"26c97584",972:"0981a0e3",985:"100050a3"}[e]+".js",d.miniCssF=e=>{},d.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),d.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),a={},o="de-intern-tutorial:",d.l=(e,t,r,n)=>{if(a[e])a[e].push(t);else{var f,i;if(void 0!==r)for(var c=document.getElementsByTagName("script"),u=0;u{f.onerror=f.onload=null,clearTimeout(s);var o=a[e];if(delete a[e],f.parentNode&&f.parentNode.removeChild(f),o&&o.forEach((e=>e(r))),t)return t(r)},s=setTimeout(b.bind(null,void 0,{type:"timeout",target:f}),12e4);f.onerror=b.bind(null,f.onerror),f.onload=b.bind(null,f.onload),i&&document.head.appendChild(f)}},d.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},d.p="/de-intern-guide/",d.gca=function(e){return e={17896441:"918","935f2afb":"53","1f391b9e":"85","356a0ac6":"117",a3696a00:"119","18d4c4b8":"152",f8409a7e:"206","01232042":"241",e27ea86e:"262",a9ca83f8:"329",a9ea4256:"405","393be207":"414","321014e7":"432","1be78505":"514","0ab13595":"617",b51a1159:"627","73ae107a":"762","0f1f73a8":"764","0f0cf65e":"795",a53e4d49:"798","14eb3368":"817","010f034f":"827","5a2b65ac":"838","1d769a5c":"904","095073fd":"920","7aa35b29":"935",f269bf4d:"985"}[e]||e,d.p+d.u(e)},(()=>{var e={303:0,532:0};d.f.j=(t,r)=>{var a=d.o(e,t)?e[t]:void 0;if(0!==a)if(a)r.push(a[2]);else if(/^(303|532)$/.test(t))e[t]=0;else{var o=new Promise(((r,o)=>a=e[t]=[r,o]));r.push(a[2]=o);var n=d.p+d.u(t),f=new Error;d.l(n,(r=>{if(d.o(e,t)&&(0!==(a=e[t])&&(e[t]=void 0),a)){var o=r&&("load"===r.type?"missing":r.type),n=r&&r.target&&r.target.src;f.message="Loading chunk "+t+" failed.\n("+o+": "+n+")",f.name="ChunkLoadError",f.type=o,f.request=n,a[1](f)}}),"chunk-"+t,t)}},d.O.j=t=>0===e[t];var t=(t,r)=>{var a,o,n=r[0],f=r[1],i=r[2],c=0;if(n.some((t=>0!==e[t]))){for(a in f)d.o(f,a)&&(d.m[a]=f[a]);if(i)var u=i(d)}for(t&&t(r);c{"use strict";var e,t,r,a,o,n={},f={};function d(e){var t=f[e];if(void 0!==t)return t.exports;var r=f[e]={id:e,loaded:!1,exports:{}};return n[e].call(r.exports,r,r.exports,d),r.loaded=!0,r.exports}d.m=n,d.c=f,e=[],d.O=(t,r,a,o)=>{if(!r){var n=1/0;for(u=0;u=o)&&Object.keys(d.O).every((e=>d.O[e](r[i])))?r.splice(i--,1):(f=!1,o0&&e[u-1][2]>o;u--)e[u]=e[u-1];e[u]=[r,a,o]},d.n=e=>{var t=e&&e.__esModule?()=>e.default:()=>e;return d.d(t,{a:t}),t},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,d.t=function(e,a){if(1&a&&(e=this(e)),8&a)return e;if("object"==typeof e&&e){if(4&a&&e.__esModule)return e;if(16&a&&"function"==typeof e.then)return e}var o=Object.create(null);d.r(o);var n={};t=t||[null,r({}),r([]),r(r)];for(var f=2&a&&e;"object"==typeof f&&!~t.indexOf(f);f=r(f))Object.getOwnPropertyNames(f).forEach((t=>n[t]=()=>e[t]));return n.default=()=>e,d.d(o,n),o},d.d=(e,t)=>{for(var r in t)d.o(t,r)&&!d.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},d.f={},d.e=e=>Promise.all(Object.keys(d.f).reduce(((t,r)=>(d.f[r](e,t),t)),[])),d.u=e=>"assets/js/"+({53:"935f2afb",85:"1f391b9e",117:"356a0ac6",119:"a3696a00",152:"18d4c4b8",206:"f8409a7e",241:"01232042",262:"e27ea86e",329:"a9ca83f8",405:"a9ea4256",414:"393be207",432:"321014e7",514:"1be78505",617:"0ab13595",627:"b51a1159",762:"73ae107a",764:"0f1f73a8",795:"0f0cf65e",798:"a53e4d49",817:"14eb3368",827:"010f034f",838:"5a2b65ac",904:"1d769a5c",918:"17896441",920:"095073fd",935:"7aa35b29",985:"f269bf4d"}[e]||e)+"."+{53:"ec4aa3da",85:"9cf78ad5",117:"14cf7ee2",119:"69839c27",152:"f4b1aff4",206:"cbf970c8",241:"9dc00bc5",262:"615cb4b9",329:"d40db704",405:"2a98d330",414:"1d2f2320",432:"a44e453a",455:"907a2712",514:"542f6b54",617:"03cbfe8d",627:"701a27cd",762:"26e546de",764:"eaeaad6c",795:"eb7870ee",798:"7f7217ba",817:"56d64c00",827:"437add93",838:"f6bd3c5d",904:"fdd7684e",918:"e27ac847",920:"fea4e386",935:"26c97584",972:"0981a0e3",985:"100050a3"}[e]+".js",d.miniCssF=e=>{},d.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),d.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),a={},o="de-intern-tutorial:",d.l=(e,t,r,n)=>{if(a[e])a[e].push(t);else{var f,i;if(void 0!==r)for(var c=document.getElementsByTagName("script"),u=0;u{f.onerror=f.onload=null,clearTimeout(s);var o=a[e];if(delete a[e],f.parentNode&&f.parentNode.removeChild(f),o&&o.forEach((e=>e(r))),t)return t(r)},s=setTimeout(l.bind(null,void 0,{type:"timeout",target:f}),12e4);f.onerror=l.bind(null,f.onerror),f.onload=l.bind(null,f.onload),i&&document.head.appendChild(f)}},d.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},d.p="/de-intern-guide/",d.gca=function(e){return e={17896441:"918","935f2afb":"53","1f391b9e":"85","356a0ac6":"117",a3696a00:"119","18d4c4b8":"152",f8409a7e:"206","01232042":"241",e27ea86e:"262",a9ca83f8:"329",a9ea4256:"405","393be207":"414","321014e7":"432","1be78505":"514","0ab13595":"617",b51a1159:"627","73ae107a":"762","0f1f73a8":"764","0f0cf65e":"795",a53e4d49:"798","14eb3368":"817","010f034f":"827","5a2b65ac":"838","1d769a5c":"904","095073fd":"920","7aa35b29":"935",f269bf4d:"985"}[e]||e,d.p+d.u(e)},(()=>{var e={303:0,532:0};d.f.j=(t,r)=>{var a=d.o(e,t)?e[t]:void 0;if(0!==a)if(a)r.push(a[2]);else if(/^(303|532)$/.test(t))e[t]=0;else{var o=new Promise(((r,o)=>a=e[t]=[r,o]));r.push(a[2]=o);var n=d.p+d.u(t),f=new Error;d.l(n,(r=>{if(d.o(e,t)&&(0!==(a=e[t])&&(e[t]=void 0),a)){var o=r&&("load"===r.type?"missing":r.type),n=r&&r.target&&r.target.src;f.message="Loading chunk "+t+" failed.\n("+o+": "+n+")",f.name="ChunkLoadError",f.type=o,f.request=n,a[1](f)}}),"chunk-"+t,t)}},d.O.j=t=>0===e[t];var t=(t,r)=>{var a,o,n=r[0],f=r[1],i=r[2],c=0;if(n.some((t=>0!==e[t]))){for(a in f)d.o(f,a)&&(d.m[a]=f[a]);if(i)var u=i(d)}for(t&&t(r);c ✈ Onboarding Setup | Intern Onboarding Guide - +

✈ Onboarding Setup

Installation instructions to setting up your workspace with the necessary software and tools.

- + \ No newline at end of file diff --git a/category/-qsv/index.html b/category/-qsv/index.html index f03bcea..a160de2 100644 --- a/category/-qsv/index.html +++ b/category/-qsv/index.html @@ -4,13 +4,13 @@ ⚡ qsv | Intern Onboarding Guide - +

⚡ qsv

Learn about qsv, the data wrangling tool!

- + \ No newline at end of file diff --git a/category/-technical-writing/index.html b/category/-technical-writing/index.html index 63e798d..4d3d0d5 100644 --- a/category/-technical-writing/index.html +++ b/category/-technical-writing/index.html @@ -4,13 +4,13 @@ ✍ Technical Writing | Intern Onboarding Guide - +

✍ Technical Writing

How to write technical documentation and organize your work.

- + \ No newline at end of file diff --git a/index.html b/index.html index 431be5c..26bd79c 100644 --- a/index.html +++ b/index.html @@ -4,13 +4,13 @@ 👋 Welcome to datHere! | Intern Onboarding Guide - +

👋 Welcome to datHere!

✨ Overview​

Glad to have you here 🎉! This guide serves as a reference for new interns at datHere.

If you have any more questions that aren't answered here, please reach out to your team members on Slack.

🙌 Sounds great! How do I get started?​

Click the "Next" button below to get started!

You can also navigate the guide using the sidebar on the left.

If you're on a mobile device you can click on the three lines in the top left corner to open the sidebar.

- + \ No newline at end of file diff --git a/markdown-page/index.html b/markdown-page/index.html index 6812e02..bf2baa6 100644 --- a/markdown-page/index.html +++ b/markdown-page/index.html @@ -4,13 +4,13 @@ Markdown page example | Intern Onboarding Guide - +

Markdown page example

You don't need React to write simple standalone pages.

- + \ No newline at end of file diff --git a/onboarding/ckan-setup/index.html b/onboarding/ckan-setup/index.html index 7a8489b..bbe99a7 100644 --- a/onboarding/ckan-setup/index.html +++ b/onboarding/ckan-setup/index.html @@ -4,13 +4,13 @@ 📊 CKAN Setup | Intern Onboarding Guide - +
- + \ No newline at end of file diff --git a/onboarding/datapusher-plus-setup/index.html b/onboarding/datapusher-plus-setup/index.html index e00538f..faa4627 100644 --- a/onboarding/datapusher-plus-setup/index.html +++ b/onboarding/datapusher-plus-setup/index.html @@ -4,13 +4,13 @@ 📮 DataPusher+ Setup | Intern Onboarding Guide - +
- + \ No newline at end of file diff --git a/onboarding/github-setup/index.html b/onboarding/github-setup/index.html index 1a9ed07..91b0960 100644 --- a/onboarding/github-setup/index.html +++ b/onboarding/github-setup/index.html @@ -4,13 +4,13 @@ 🖥 GitHub Setup | Intern Onboarding Guide - +

🖥 GitHub Setup

👋 Welcome!​

You may have seen GitHub before or heard about it, and now it's time to learn more and set up your GitHub account!

💭 What's GitHub?​

GitHub is like a virtual playground for coders. You may store your code, share it with others, and even collaborate on projects using Git.

Git & GitHub: What's the difference?
  • Git is a version control system (also a command line tool) which can assist in managing code history.
  • GitHub is a service where code can be hosted.

There are many more differences and explanations, so feel free to take a search in your search engine!

✨ Cool Features​

Here are some very brief descriptions of features you may find often using GitHub:

FeatureBrief description
Version controlGitHub can host code repositories which use Git, and GitHub provides a GUI that works with Git
CollaborationWork with friends, coworkers, or even anyone random users from around the world on projects
IssuesTrack ideas, tasks, feedback, bugs, plans, and more
Pull requestsPropose a set of (code) changes from one branch to another and review changes (commonly abbreviated as 'PR')
ProjectsProject management tool that can help keep track of issues & PRs, including views like kanban boards & tables
DiscussionsSimilar to an online forum, another avenue for a repository's community to connect

There are plenty more features GitHub has to offer. Get started with GitHub by following the quest below!

🗺 Your GitHub Quest​

  1. Create a GitHub account at github.com.
  2. Explore repositories and find one you think is interesting.
  3. Skim the issues for the repository and see if you think you can solve one of them.
  4. Fork the repository.
  5. Clone the fork to your device, make changes, push the changes to your fork, then create a PR to the original repository.

If you get stuck, are not sure what something means, or can't find an issue that you think you can solve, try searching on your search engine and if that doesn't work then contact your team.

💻 Your GitHub Super Move: Collaboration​

GitHub is not just for code; it's for making cool (and hopefully useful!) things together. Try collaborating on a project, and have fun working with people around the world!

🚀 Ready to code?​

Explore, collaborate, and have fun coding! 👋

- + \ No newline at end of file diff --git a/onboarding/qsv-pro-setup/index.html b/onboarding/qsv-pro-setup/index.html index b66d5e0..e8541e9 100644 --- a/onboarding/qsv-pro-setup/index.html +++ b/onboarding/qsv-pro-setup/index.html @@ -4,13 +4,13 @@ ⚙️ qsv pro Setup | Intern Onboarding Guide - +

⚙️ qsv pro Setup

ℹ About qsv pro​

Welcome to qsv pro, a powerful desktop app designed for spreadsheet data wrangling. Built on the foundation of the qsv CLI tool, qsv pro offers a feature-packed local GUI for an enhanced user experience.

Learn more about qsv pro at qsvpro.dathere.com or read the intern guide post.

🗺 Installation Guide​

Follow these steps to install and try out qsv pro on your system.

📥 Step 1: Download the Installer​

Visit the qsv pro Releases page on GitHub.

💻 Step 2: Choose the Installer Package​

Select and download the installer package compatible with your operating system.

🛠 Step 3: Installation Procedure​

Run the installer and complete the installation procedure following the on-screen instructions for your operating system.

🧪 Step 4: Testing (Under Development)​

Explore qsv pro's features! Manipulate spreadsheets, navigate the user interface, and provide valuable feedback to the development team.

🚀 Step 5: Have fun!​

Have fun experiencing the efficiency and convenience of qsv pro's data wrangling capabilities on your computer!

- + \ No newline at end of file diff --git a/onboarding/qsv-setup/index.html b/onboarding/qsv-setup/index.html index 3f15c4b..aad4504 100644 --- a/onboarding/qsv-setup/index.html +++ b/onboarding/qsv-setup/index.html @@ -4,13 +4,13 @@ ⚡ qsv Setup | Intern Onboarding Guide - +

⚡ qsv Setup

In this section we'll go over how to install qsv and get it running on your Ubuntu VM.

📝 Written Tutorial​

There are various methods for installing qsv. We've categorized the installation options based on your objective.

💻 Install qsv for general usage​

If you intend on using qsv as a command line tool anywhere on your system (globally), then choose and complete the steps for one of the following options to install qsv:

🛠 Install qsv for development​

If you intend on developing, maintaining, and/or contributing to qsv, complete the steps for option 4 to install qsv within a folder (locally).

- + \ No newline at end of file diff --git a/onboarding/setup-overview/index.html b/onboarding/setup-overview/index.html index dd8e17d..06aba1b 100644 --- a/onboarding/setup-overview/index.html +++ b/onboarding/setup-overview/index.html @@ -4,13 +4,13 @@ 🗺 Setup Overview | Intern Onboarding Guide - +

🗺 Setup Overview

Before you start diving into awesome projects and working with your team, you'll need the right equipment 🛠💼.

Refer to the upcoming sections to help you install everything. For now, let's take a look at the cool tools you'll be setting up 🤘!

😎 Cool Tools!​

Software/ToolDescription
VirtualBoxVirtualBox is a virtualization software that allows you to run a virtual machine on your computer. Simply put, this program lets you have virtual computers inside your computer!
UbuntuUbuntu is a free and open-source operating system. It is a Linux distribution and is often useful for running on virtual machines.
qsvqsv (pronounced "Quicksilver") is a command line program for indexing, slicing, analyzing, filtering, enriching, validating & joining CSV files. Commands are simple, fast & composable.
CKANCKAN is an open-source DMS (data management system) for powering data hubs and data portals. CKAN makes it easy to publish, share, and use data. It powers hundreds of data portals worldwide.
DataPusher+ with DockerDataPusher+ is standalone web service that pushes data into the CKAN DataStore fast & reliably. We'll be setting up a containerized version of DataPusher+ by using Docker.

🧩 Putting It All Together​

We'll use VirtualBox to create a virtual machine (VM) running Ubuntu. On your VM you can use and contribute to qsv, CKAN (including CKAN extensions), DataPusher+, and much more! 🚀

One more thing! 🎈

Though using a VM is not required and you can do development on your own setup, the guide will cover running an Ubuntu guest OS through a VM using VirtualBox on a Windows 10 host OS. If you're using a different setup (such as a different host OS), you may need to adjust your steps accordingly.

- + \ No newline at end of file diff --git a/onboarding/ubuntu-vm-setup/index.html b/onboarding/ubuntu-vm-setup/index.html index a714451..08f4e00 100644 --- a/onboarding/ubuntu-vm-setup/index.html +++ b/onboarding/ubuntu-vm-setup/index.html @@ -4,13 +4,13 @@ 💻 Ubuntu VM Setup | Intern Onboarding Guide - +

💻 Ubuntu VM Setup

In this section we cover how to install VirtualBox on your operating system (OS) and run Ubuntu 22.04.2 LTS on a virtual machine (VM).

📝 Written Tutorial​

You may find more comprehensive instructions and details on the online user manual for VirtualBox 7.0.

📥 Download VirtualBox & the Extension Pack​

  1. Go to the VirtualBox downloads page.
  2. Download the VirtualBox platform package based on your computer's OS.

For example, since I'm on a computer running Windows 10 as my OS, then I would choose "Windows hosts".

  1. Download the VirtualBox Oracle VM VirtualBox Extension Pack.

VirtualBox download page

🛠 Install VirtualBox & the Extension Pack​

  1. Run the VirtualBox installer. Select Yes if prompted to allow VirtualBox Installer to make changes to your device.

VirtualBox Installer Yes

Click here if you get an error that says:

Oracle VM VirtualBox needs the Microsoft Visual C++ 2019 Redistributable Package being installed first. Please install and restart the installation of Oracle VM Virtualbox.

VirtualBox Installer Error

To fix this issue, install the appropriate package for your system from this website.

Choose the correct download link for your system. On Windows 10 you can find your system type by opening the System Information app and reading the System Type value.

System Information

System Type

Visual Package Download Page

Agree to the license terms and conditions, press Install, press Yes if prompted to allow the program to make changes to your device, and the setup should successfully complete and you can click Close.

  1. On the installation wizard popup, click "Next".

VirtualBox Wizard

  1. You may change the location for installing VirtualBox by clicking the Browse button. Then click Next.

  2. Click Yes for the Warning: Network Interfaces and Missing Dependencies Python Core / win32api sections.

  3. Click Install and wait for the installation to complete. Then click Finish.

You have now successfully installed VirtualBox.

  1. Run the VirtualBox Extension Pack that you downloaded before. Select Yes if prompted to allow VirtualBox Installer to make changes to your device.

VirtualBox Extension Pack Install

You have now successfully installed the VirtualBox Extension Pack.

📥 Download Ubuntu 22.04.2 LTS​

caution

Make sure your computer fulfills recommended system requirements for Ubuntu 22.04.2 LTS:

  • 2 GHz dual-core processor or better
  • 4 GB system memory
  • 25 GB of free hard drive space

You'll also need ~5 GB of space for the downloaded .iso file, though you can delete the file once you've fully setup the VM.

  1. Go to the Ubuntu Desktop downloads page.
  2. Download Ubuntu 22.04.2 LTS by clicking the green Download 22.04.2 button.

Ubuntu download page

🖥 Setup a Virtual Machine (VM)​

  1. Open up VirtualBox and click the New button (you can also click on the Machine menu then press New).

VirtualBox New Button

  1. On the new popup, provide a name that you'd like to identify your VM, the folder in which you'd like to install your VM, and the Ubuntu .iso file that you've downloaded. Then click Next.

VirtualBox Name & OS

  1. Enter a valid username, password, hostname (this is what Ubuntu considers its name as), and enable Guest Additions along with pointing to its .iso file. Then click Next.

VirtualBox Guest OS Setup

  1. Set the Base Memory and Processors to the appropriate settings. You may have different values but a general guideline is to stay anywhere within the green section up until the border with the orange section. Generally the more you allocate, the faster the VM. Then click Next.

VirtualBox Hardware

  1. Select Create a Virtual Hard Disk Now and set a Disk Size of at least 25 GB. Then click Next.

VirtualBox Hard Disk

  1. Click Finish on the Summary page. Your VM should now be powering up and it may take a while for Ubuntu to install.

🏁 Final Steps​

  1. On your Ubuntu VM, login to your account with the username and password you set earlier.

Ubuntu Login

  1. Click Skip or Next on the top right for the welcome screen that appears (adjust any settings based on your preferences).

  2. Click Done to finish the welcome screen.

You have now successfully installed Ubuntu.

Ubuntu Desktop

✨ Bonus Tips​

  • Take a snapshot of your virtual machine now!
  • Learn more about the terminal and things to do after installing Ubuntu here.
  • You can modify the display size and other settings from the View menu option:

VirtualBox display size setting

- + \ No newline at end of file diff --git a/qsv/qsv-cli/index.html b/qsv/qsv-cli/index.html index 9f7e202..4ddc0d8 100644 --- a/qsv/qsv-cli/index.html +++ b/qsv/qsv-cli/index.html @@ -4,13 +4,13 @@ ⚡ qsv | Intern Onboarding Guide - +

⚡ qsv

Meet qsv, your new command line tool for data wrangling!

💭 What's qsv?​

qsv is a command line tool with 50+ commands that can perform data wrangling tasks in a relatively efficient manner.

For example, if I had a csv file that looked like this:

prices.csv
id,fruit,cost
1,apple,5.00
2,banana,10.00
3,celery,2.00

Then I can use qsv to perform all sorts of commands based on the data. Maybe I want to simply count how many rows there are (not including the header row). I can run:

qsv count prices.csv

And the output would be 3. But I can add flags for even more options like additionally getting the number of characters in the longest row by adding --width (e.g., qsv count prices.csv --width), and other commands also have subcommands!

✨ Cool Features​

  • 50+ commands: There's plenty of options for users for all sorts of backgrounds to use qsv in their workflow
  • Blazingly fast: qsv is built primarily with the Rust programming language, offering fast speeds even for very large datasets
  • Mix and match: Combine different qsv commands and integrate qsv with other tools to enhance data wrangling

🛠 Install qsv​

  1. Install qsv.
  2. Once installed, run qsv --list to list the commands available to you, and you can further learn about them by running qsv <command> --help where <command> is the command you want to learn about (e.g., qsv count --help).
  3. Try running qsv commands on your files!

📊 Your first command: qsv count​

Navigate to your desired .csv file on the terminal and try typing qsv count <filename> (where <filename> is the name of your file) and see what happens!

See if you can try following along in the intro-to-count.ipynb notebook.

🚀 Ready for some data wrangling?​

That's just the beginning! Explore more commands, use qsv to perform various transformations, and have fun wrangling data with qsv!

Remember, qsv can help make data exciting and easy, even if you're just starting on your data journey!

- + \ No newline at end of file diff --git a/qsv/qsv-pro/index.html b/qsv/qsv-pro/index.html index c1e2a25..d6b156b 100644 --- a/qsv/qsv-pro/index.html +++ b/qsv/qsv-pro/index.html @@ -4,13 +4,13 @@ 💻 qsv pro | Intern Onboarding Guide - +

💻 qsv pro

Get ready to level up your data game with qsv pro! 🚀

💭 What's qsv pro?​

qsv pro is a spreadsheet data wrangling desktop app.

It offers a graphical user interface (GUI) based on the qsv command line interface (CLI).

✨ Super Features​

Spreadsheet data table viewer​

Data table viewer demo

Stats, frequency, and metadata data tables​

Recipes (scripts) to transform data​

CKAN upload workflow​

The upload feature is getting a major update soon!

Resizable panels​

Light & Dark themes​

Theme switch demo

🌊 Let's Dive In!​

  1. Set up qsv pro.
  2. Launch qsv pro and explore the various features on your files. Just drag and drop a spreadsheet (CSV, Excel file, and more) into qsv pro and watch what happens!
  3. Share your experience with your team and provide feedback to the developers.

🚀 Ready for a pro experience?​

View, transform, and upload your spreadsheets with a streamlined GUI using qsv pro.

- + \ No newline at end of file diff --git a/qsv/qsv-web/index.html b/qsv/qsv-web/index.html index df121c2..f486bc8 100644 --- a/qsv/qsv-web/index.html +++ b/qsv/qsv-web/index.html @@ -4,13 +4,13 @@ 🖱 qsv.dathere.com | Intern Onboarding Guide - +

🖱 qsv.dathere.com

qsv is also available on the web! A subset of qsv commands are available to run at qsv.dathere.com.

🌱 Benefits​

Here are some benefits of qsv.dathere.com:

  • 👋 User-Friendly Interface: Built with daisyUI, qsv.dathere.com is a neat way to interact with qsv
  • 🔌 No Installation Required: Hosted on the web and powered by the qsv CLI, no need to install the qsv CLI or qsv pro GUI
  • 📱 Platform Independence: Simply go to the web app on a desktop/mobile browser
  • 📊 Interactive Data Previews: A data table is generated based on command outputs

🌐 Accessing qsv.dathere.com​

To access the qsv.dathere.com, simply visit the website: qsv.dathere.com. It's a user-friendly platform that provides powerful data manipulation tools with just a few clicks. 🚀

🗺 UI Overview​

🏡Home​

"Home" is your starting point for qsv.dathere.com, a welcome page where you may begin browsing.

Home GIF

🌐 Web​

"Web" is where you may run various qsv commands on your file(s) with a point-and-click UI without having to type any CLI commands.

Web GIF

⏱️ Benchmarks​

"Benchmarks" is where you may data on qsv's performance and compare against previous versions of qsv.

Benchmarks GIF

💻 Web commands​

On the Web commands page, you'll find a grid of qsv commands with brief descriptions, many of which you may use in the browser.

Simply click on the qsv command you want to use, provide your input file(s), select various flags and potentially subcommands, then press the run button.

Why can't I select certain commands?

Certain commands are unavailable since there currently isn't an automated process for integrating qsv into a web UI, so many commands were manually added for the web app.

Web commands GIF

Command example​

For instance, let's choose the "behead" command.

This is a relatively simple command that removes the first row from your CSV, removing the header row.

Upload by clicking the 'Choose File' buttonor Drag and Drop
File upload exampleDrag and drop example

Once you've uploaded the CSV file you want to work with, simply click on the 'RUN BEHEAD!' button and see what happens!

Run button example

Command preview

Data table preview

Raw output preview

- + \ No newline at end of file diff --git a/technical-writing/daily-standups/index.html b/technical-writing/daily-standups/index.html index 076ec99..14e9fc4 100644 --- a/technical-writing/daily-standups/index.html +++ b/technical-writing/daily-standups/index.html @@ -4,13 +4,13 @@ ☕ Daily Standups | Intern Onboarding Guide - +
-

☕ Daily Standups

You'll often greet your workday with a standup meeting. This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing.

To stay on track on a daily basis, it can be very helpful to organize yourself before, during, and after this meeting.

🏁 Before the Standup​

Try to write down the following before your standup meeting:

  • 🎉 What you've accomplished since the last standup meeting
  • 🛠 What you plan to continue working on or work on next
  • ❌ "Blockers" you are facing, which are things that stop you from continuing work on a task or project
  • ❓ Questions you have for any team member (or in general) that you couldn't get answered over your team communication platform

🏎 During the Standup​

When it's your turn, cover the points you wrote down without going into too much extensive detail (as you should put any extra details in your notes or kanban board). Ask to setup a meeting with any team member you have questions for if you can't get them answered during the standup or if what you're working on requires more discussion and doesn't need the entire team's attention.

Also make sure to write down any new tasks or to-dos assigned to you during the standup. 📃

🏆 After the Standup​

Review what you've written down and make sure you've answered all your questions and resolved any blockers. If you haven't, make sure to follow up with the appropriate team members. If you use a kanban board or any tracker for your tasks and projects, add any new tasks assigned to you to your board and update any notes or progress you've made on your tasks.

Now you have a good idea of what you need to do for the day. Get to work! 💼

🧩 Daily Standup Notes Template​

Here's a Markdown template you can use daily to keep track of your standup notes:

# 📅 [Date] Daily Standup

## 🎉 Accomplished

> What tasks you've completed or goals you've accomplished or made progress on.

-

## 🛠 Working On

> What you are currently working on or plan to start working on and how much progress you expect to make. Also when you complete or make progress on your tasks, write down what you've done for tomorrow's Accomplished section.

-

## ❌ Blockers

> Problems you're facing that stop you from continuing work.

-

## ❓ Questions

> Any specific questions you have for any team member or in general. Make sure you write down the answers when you get them too.

-

## 📃 Todo

> Any new tasks assigned, meetings to setup, etc. that you may also add to your kanban board.

- [ ]

Personally I like to use Obsidian to keep track of my daily standup notes (especially with its Daily Notes plugin), but you can use any note-taking app you like.

- +

☕ Daily Standups

You'll often greet your workday with a standup meeting. This is a meeting where you and your team members share what you've accomplished since the last standup meeting, what you plan to work on next, and any blockers you're facing.

To stay on track on a daily basis, it can be very helpful to organize yourself before, during, and after this meeting.

🏁 Before the Standup​

Try to write down the following before your standup meeting:

  • 🎉 What you've accomplished since the last standup meeting
  • 🛠 What you plan to continue working on or work on next
  • ❌ "Blockers" you are facing, which are things that stop you from continuing work on a task or project
  • ❓ Questions you have for any team member (or in general) that you couldn't get answered over your team communication platform

🏎 During the Standup​

When it's your turn, cover the points you wrote down without going into too much extensive detail (as you should put any extra details in your notes or kanban board). Ask to setup a meeting with any team member you have questions for if you can't get them answered during the standup or if what you're working on requires more discussion and doesn't need the entire team's attention.

Also make sure to write down any new tasks or to-dos assigned to you during the standup. 📃

🏆 After the Standup​

Review what you've written down and make sure you've answered all your questions and resolved any blockers. If you haven't, make sure to follow up with the appropriate team members. If you use a kanban board or any tracker for your tasks and projects, add any new tasks assigned to you to your board and update any notes or progress you've made on your tasks.

Now you have a good idea of what you need to do for the day. Get to work! 💼

🧩 Daily Standup Notes Template​

Here's a Markdown template you can use daily to keep track of your standup notes:

# 📅 [Date] Daily Standup

## 🎉 Accomplished

> What tasks you've completed or goals you've accomplished or made progress on.

-

## 🛠 Working On

> What you are currently working on or plan to start working on and how much progress you expect to make. Also when you complete or make progress on your tasks, write down what you've done for tomorrow's Accomplished section.

-

## ❌ Blockers

> Problems you're facing that stop you from continuing work.

-

## ❓ Questions

> Any specific questions you have for any team member or in general. Make sure you write down the answers when you get them too.

-

## 📃 Todo

> Any new tasks assigned, meetings to setup, etc. that you may also add to your kanban board.

- [ ]

Personally I like to use Obsidian to keep track of my daily standup notes (especially with its Daily Notes plugin), but you can use any note-taking app you like. Note that with Obsidian you may need to purchase a commercial use license in order to use Obsidian as your program. Another option is to use Visual Studio Code.

+ \ No newline at end of file diff --git a/technical-writing/kanban-boards/index.html b/technical-writing/kanban-boards/index.html index ee9c10d..f318dd3 100644 --- a/technical-writing/kanban-boards/index.html +++ b/technical-writing/kanban-boards/index.html @@ -4,13 +4,13 @@ 🛹 Kanban Boards | Intern Onboarding Guide - +

🛹 Kanban Boards

A kanban board is a great way to organize your tasks and projects.

Kanban boards help organize your work and keep track of what you need to do, and it can be helpful to share a kanban board with your team so everyone understands what everyone else is working on and can potentially collaborate or help each other out.

There's a project management approach called Agile that can often be used in conjunction with kanban boards.

🎈 Kanban Board Example​

Here's an example of a Kanban board that keeps track of a team's tasks using Notion:

Kanban board exampleKanban board example

🏗 Kanban Board Structure​

📊 Columns​

A kanban board is comprised of columns that represent the status of a card. For example, a common kanban board has columns for Not Started, In Progress, and Done.

💳 Cards​

Within each column are cards that represent a task or project. These cards can be moved across columns to represent their status.

You may assign a card to a team member and set a due date, a priority, the estimated amount of effort to complete the task, and more. Some tools allow you to write notes in your cards, which can help organize your research and also get others up to speed on what you're working on.

🧩 Card Template​

Here's a Markdown template you can use for your kanban cards:

## 🗺 Overview

## 📌 Tasks

- [ ]

## ❌ Blockers

-

## 🔍 Notes & Research

-

## 💡 Ideas

-

## ✨ Resources & References

-

🛠 Tools & Software​

There are many tools you can use to work with a kanban board. Here are some common ones:

- + \ No newline at end of file diff --git a/technical-writing/markdown/index.html b/technical-writing/markdown/index.html index 42c9d0c..1abd291 100644 --- a/technical-writing/markdown/index.html +++ b/technical-writing/markdown/index.html @@ -4,13 +4,13 @@ 📝 Markdown | Intern Onboarding Guide - +
-

📝 Markdown

Markdown is a markup language that is very useful for taking notes and writing documentation.

In fact, the page you're reading right now is built based on Markdown!

📚 Markdown Resources​

🏫 Learn Markdown​

📓 Markdown Editors​

Here are some Markdown editors you can use for taking notes:

note

These programs often have extra features that can be useful for taking notes, such as the ability to create kanban boards, embed images, and more. However, they do support Markdown. Also, you can instead make a new Markdown file in your favorite text editor like Visual Studio Code by saving a file with the .md extension.

- +

📝 Markdown

Markdown is a markup language that is very useful for taking notes and writing documentation.

In fact, the page you're reading right now is built based on Markdown!

📚 Markdown Resources​

🏫 Learn Markdown​

📓 Markdown Editors​

Here are some Markdown editors you can use for taking notes:

note

These programs often have extra features that can be useful for taking notes, such as the ability to create kanban boards, embed images, and more. However, they do support Markdown. Also, you can instead make a new Markdown file in your favorite text editor like Visual Studio Code by saving a file with the .md extension.

+ \ No newline at end of file diff --git a/technical-writing/technical-writing-overview/index.html b/technical-writing/technical-writing-overview/index.html index 850f626..42c0c18 100644 --- a/technical-writing/technical-writing-overview/index.html +++ b/technical-writing/technical-writing-overview/index.html @@ -4,13 +4,13 @@ 🗺 Technical Writing Overview | Intern Onboarding Guide - +

🗺 Technical Writing Overview

Though using a programming language may be important for your projects, communicating effectively is crucial for documenting your work. You may spend a lot more time on planning, organizing, and writing technical documentation. We'll cover some tips and tricks that may help you communicate your ideas clearly and effectively through technical writing.

💭 Why Learn About Technical Writing?​

Technical writing offers several benefits that can enhance your professional communication skills and help others make sense of your work, be it a codebase, a project, or any other technical subject.

Here are some benefits of technical writing:

✅ Clear communication​

Technical writing isn't about using overly complex language that just ends up being difficult to understand. It's about taking complex information and conveying them in a clear and concise manner.

👔 Professional documentation​

Technical writing can help you create professional documentation for your projects, which can help others understand your work and potentially contribute to it. Writing professional reports, proposals, presentations, and more in an organized manner can enhance your professional credibility and communication skills.

👍 User-friendly content​

Understanding your audience and what their needs, preferences, and level of expertise can help you create content that is easy to understand and accessible. This can be very helpful for creating user-friendly documentation, such as tutorials, guides, and manuals.

🛠 Maintainable projects​

Just like building furniture without instructions can be like a nightmare, working and maintaining a project without documentation can be like a nightmare. Technical writing can help you share documentation that can help you and others maintain your projects and codebases.

🚀 Improvement & collaboration​

Sharing your work with others can help you get valuable feedback from your audience to improve your work, while also allowing others to learn from your work and potentially contribute to it.

📝 Where Can I Practice Technical Writing?​

You can practice technical writing in many different scenarios, such as:

🔍 Where Can I Learn More?​

Practicing technical writing while getting feedback from others is a great way to learn where you can improve.

If you'd like to take courses on technical writing, here are a few technical writing courses from Google that you can take for free:

CourseSummary
Technical Writing OneLearn the critical basics of technical writing. Take this course before taking any of the other courses.
Technical Writing TwoPractice four intermediate topics in technical writing.
Writing Helpful Error MessagesWrite clearer, more effective error messages, whether they appear in IDEs, command lines, or GUIs.

I suggest adding course recommendations to your kanban board and updating your progress as you go through them.

More importantly however, I suggest practicing technical writing in various scenarios and getting feedback from others.

- + \ No newline at end of file