From c7bc37d8e626a00e6eda5bb2c268be2134e496e7 Mon Sep 17 00:00:00 2001
From: G-T-P <45485090+G-T-P@users.noreply.github.com>
Date: Thu, 6 Dec 2018 16:16:39 +0100
Subject: [PATCH] Create atom.asc

Atom is a fairly popular IDE that fully integrates with Git. This provides rudimentary explanation on how to set up Git integration with non github remote repositories from within a windows environment.
When I set up my environment, having access to these few lines would have saved me hours of googling...
---
 .../sections/atom.asc                         | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)
 create mode 100644 book/A-git-in-other-environments/sections/atom.asc

diff --git a/book/A-git-in-other-environments/sections/atom.asc b/book/A-git-in-other-environments/sections/atom.asc
new file mode 100644
index 000000000..cc0afe763
--- /dev/null
+++ b/book/A-git-in-other-environments/sections/atom.asc
@@ -0,0 +1,23 @@
+=== Git in Atom
+
+(((Atom)))
+Atom ships with a built-in package called GitHub, which provides a fairly-complete interface to Git operations and a deep integration with the website GitHub.
+There are different ways to access the package, probably the most common way is through the keybinding:
+
+Open the Git panel: `Ctrl+9`
+
+Another way is from the menu: `Packages -> GitHub -> Toggle Git Tab`
+
+GitHub comes with plenty of documentation when it comes to the integration with a remote repository on GitHub, which you can find within atom "Flight Manual".
+But the GitHub package can also integrate with any remote repository.
+
+=== Clone repositories
+
+To clone a repository, access the command palette by typing `Ctrl + Alt + P` and then run the `GitHub: Clone` command.
+In the dialog paste a URL of a repository and click "Clone". A new project will get added to the Tree View.
+The URL to the remote repository for SSH connection should be of the form:
+
+    ssh://git@sub.domain.com:portNB/path/project.git
+
+For this operation to succeed, make sure that your git and your ssh are properly configured.
+Git is configured from a file called `.gitconfig` which must be located in your user directory (`%USERPROFILE%` on windows, run `git config` on Linux environments). Similarly SSH must be configured in a file `/.ssh/config` also located within your user directory on windows environement.