Open
Conversation
added Initial onboarding readme
| @@ -0,0 +1,34 @@ | |||
| ## How to get started with Software Development | |||
| the first step that will be required of you when starting out is to get an email address created or set up in order to receive and send relevant information and invites to other developers. | |||
Collaborator
There was a problem hiding this comment.
Suggested change
| the first step that will be required of you when starting out is to get an email address created or set up in order to receive and send relevant information and invites to other developers. | |
| An email account/inbox of your choice needs to be identified in order to send and receive email on behalf of your code laboratory accounts. GMail is prefered and the only method described as of the time of writing in the following document. |
| the first step that will be required of you when starting out is to get an email address created or set up in order to receive and send relevant information and invites to other developers. | ||
| To do this you would need to firstly access your personal email account and enable the 2-factor authentication factor as well as verify the email address is both able to receive and send mail, the way in which we do this is by using a tool called ismyemailworking | ||
| [click here](http://ismyemailworking.com/) | ||
| to create the forwarding address using Gmail you will need to log in to the destination address and open the accounts tab in the settings menu from here the next step is to click the add another address in to send mail as section and thn untick the treat as alias box that comes up, you will then need to use the correct server type and the password that is generated for the new address to finish setting up the business email forwarder. it is at this point that the ismyemail working tool will be used. |
Collaborator
There was a problem hiding this comment.
consider rewording to flow better
Suggested change
| to create the forwarding address using Gmail you will need to log in to the destination address and open the accounts tab in the settings menu from here the next step is to click the add another address in to send mail as section and thn untick the treat as alias box that comes up, you will then need to use the correct server type and the password that is generated for the new address to finish setting up the business email forwarder. it is at this point that the ismyemail working tool will be used. | |
| to create the forwarding address using Gmail you will need to log in to the destination address and open the accounts tab in the settings menu from here the next step is to click the add another address in to send mail as section and thn untick the treat as alias box that comes up, you will then need to use the correct server type and the password that is generated for the new address to finish setting up the business email forwarder. it is at this point that the [ismyemailworking](http://ismyemailworking.com/) working tool will be used. |
onboarding.md
Outdated
| after setting up the business email explained in the previous section the next step is to get your work machine up to date with all the required software versions and tools. | ||
| these are the tools needed from the get go: | ||
|
|
||
| ##homebrew |
Collaborator
There was a problem hiding this comment.
Suggested change
| ##homebrew | |
| ## homebrew |
onboarding.md
Outdated
|
|
||
| ##golang | ||
| golang is a type of programming language that is used by many types of developers for creating the software as it is a much easier and smoother language to use than some other available languages not only this, but it also has a much faster run and compile time when compared to other similar types of languages. it is also a lot easier to learn to use than other available languages making it a great choice for someone who is just starting out in this industry. the installation for goland is fairly simple it is downloaded off of chrome and the file is then opened up and installed onto the machine in the case of a MAC it is dragged into the application's folder. once the program is open and running you can link it to your GitHub account as this allows the programmer to access the different URLs they are currently working on whilst inside the goland window allowing a much more convenient method of opening and finding required files.[goland](https://www.jetbrains.com/go/promo/?source=google&medium=cpc&campaign=10165081599&gclid=CjwKCAjwy7CKBhBMEiwA0Eb7ajtsjeN8VB1aZAl00Xbf3ypifKKEil0FfV_MOqd8Xy_x1gWWpnQNmBoCiesQAvD_BwE) a good website to learn the basics of goland is [tutorial](https://www.w3schools.com/go/index.php) as it offers a well explained tutorial as well as opportunities to test out the different functions and factors explained throughout as well as small exercises to help you learn by doing practical and theoretical training. | ||
| ( |
Collaborator
There was a problem hiding this comment.
[this is the alt text ] this is what is read out to blind users who can't see the image in place of the image. Text to speech tools also read this out aloud. Typically this should be a short description of what the image is.
| these are the tools needed from the get go: | ||
|
|
||
| ##homebrew | ||
| Homebrew is used to install the other tools in a bash window as well as used to update certain aspects. this software can be downloaded off of Google Chrome by using the following link [homebrew](https://brew.sh/) after down you copy the code on the website you will then need to open up the standard terminal that comes on your chosen software and paste the line into the terminal to install the program. |
Collaborator
There was a problem hiding this comment.
we only need to consider mac users right now
| Slack is a software similar to GitHub in the fact that it is used within an organisation however the varying factor is that slack is only used to communicate via text channels as well as audio and video calls. to install slack it is similar to GitHub as it is downloaded from chrome and then an account is created, before you are able to communicate with the other members of the organisation you must receive an invitation just like is the case when first installing GitHub after this the software is easy to use and is very efficient at allowing multiple members to communicate at the same time in different text channels or servers.[Slack](https://slack.com/intl/en-gb/) | ||
|
|
||
| ##golang | ||
| golang is a type of programming language that is used by many types of developers for creating the software as it is a much easier and smoother language to use than some other available languages not only this, but it also has a much faster run and compile time when compared to other similar types of languages. it is also a lot easier to learn to use than other available languages making it a great choice for someone who is just starting out in this industry. the installation for goland is fairly simple it is downloaded off of chrome and the file is then opened up and installed onto the machine in the case of a MAC it is dragged into the application's folder. once the program is open and running you can link it to your GitHub account as this allows the programmer to access the different URLs they are currently working on whilst inside the goland window allowing a much more convenient method of opening and finding required files.[goland](https://www.jetbrains.com/go/promo/?source=google&medium=cpc&campaign=10165081599&gclid=CjwKCAjwy7CKBhBMEiwA0Eb7ajtsjeN8VB1aZAl00Xbf3ypifKKEil0FfV_MOqd8Xy_x1gWWpnQNmBoCiesQAvD_BwE) a good website to learn the basics of goland is [tutorial](https://www.w3schools.com/go/index.php) as it offers a well explained tutorial as well as opportunities to test out the different functions and factors explained throughout as well as small exercises to help you learn by doing practical and theoretical training. |
Collaborator
There was a problem hiding this comment.
hyper link looks very temoral. I think this can probably be shortened to just https://www.jetbrains.com/go
Collaborator
|
Overall great work and congratulations on creating your first pull request! 👏 🙌 🎆 🎉 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Initial onboarding readme