Cleaning up GIT bindings

Author: polterguy

backend/files/misc/common-startup-files/default-files/functions/git/git-add-remote.md

@@ -0,0 +1,20 @@
+# Function; Git Add Remote
+FUNCTION ==> git-remote-add
+
+Adds a remote upstream to the specified local repo.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/git-remote-add.hl]:
+{
+  "path": "[STRING_VALUE]",
+  "url": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `path` is the mandatory folder of where your repository is.
+* `url` is the mandatory URL for the Git repo.
+
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".
+ 

backend/files/misc/common-startup-files/default-files/functions/git/git-checkout-branch.md

@@ -18,4 +18,4 @@ ___
 * `branch` is the mandatory branch you want to checkout.
 * `create` is an optional boolean, which if true, creates a new branch.
 
-Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `folder` argument must point inside of "/etc/" or "/modules/".
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".

backend/files/misc/common-startup-files/default-files/functions/git/git-clone-repo.md

@@ -20,4 +20,4 @@ ___
 * `branch` is the mandatory branch you want to initially checkout.
 * `create` is an optional boolean, which if true, creates a new branch.
 
-Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `folder` argument must point inside of "/etc/" or "/modules/". Paths must **ALWAYS** start and end with "/".
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/". Paths must **ALWAYS** start and end with "/".

backend/files/misc/common-startup-files/default-files/functions/git/git-commit.md

@@ -0,0 +1,20 @@
+# Function; Git Commit
+FUNCTION ==> git-commit
+
+Commits all changes to the local Git repository.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/git-commit.hl]:
+{
+  "path": "[STRING_VALUE]",
+  "message": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `path` is the mandatory folder of where your repository is.
+* `message` is the mandatory message for the commit.
+
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".
+ 

backend/files/misc/common-startup-files/default-files/functions/git/git-create-repo.md

@@ -0,0 +1,20 @@
+# Function; Git Create Repo
+FUNCTION ==> git-create-repo
+
+Creates and initialises a new Git repository locally.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/git-create-repo.hl]:
+{
+  "path": "[STRING_VALUE]",
+  "branch": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `path` is the mandatory folder of where your repository is.
+* `branch` is the mandatory default branch for repository.
+
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".
+ 

backend/files/misc/common-startup-files/default-files/functions/git/git-delete-repo.md

@@ -0,0 +1,18 @@
+# Function; Git Delete Repo
+FUNCTION ==> git-delete-repo
+
+Deletes an existing Git repository on the local machine.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/git-delete-repo.hl]:
+{
+  "path": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `path` is the mandatory folder of where your repository is.
+
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".
+ 

backend/files/misc/common-startup-files/default-files/functions/git/git-push.md

@@ -0,0 +1,24 @@
+# Function; Git Push
+FUNCTION ==> git-push
+
+Pushes all changes to Git repository upstreams.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/git-push.hl]:
+{
+  "path": "[STRING_VALUE]",
+  "remote": "[STRING_VALUE]",
+  "branch": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `path` is the mandatory folder of where your repository is.
+* `remote` is optional remote value. Defaults to 'origin'.
+* `branch` is optional branch to push. Defaults to 'main'.
+
+Notice, you can only save files in the "/etc/" and "/modules/" folders, so the `path` argument must point inside of "/etc/" or "/modules/".
+
+Notice, before pushing a repo the repo must have a remote. You can add a remote upstream using the `git.remote.add` function.
+ 

backend/files/misc/common-startup-files/default-files/functions/git/github-create-repo.md

@@ -0,0 +1,16 @@
+# Function; GitHub Create Repo
+FUNCTION ==> github-create-repo
+
+Creates and initialises a new GitHub repository on GitHub's servers.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/github-create-repo.hl]:
+{
+  "name": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `name` is the mandatory name of your new project.
+ 

backend/files/misc/common-startup-files/default-files/functions/git/github-delete-repo.md

@@ -0,0 +1,16 @@
+# Function; GitHub Delete Repo
+FUNCTION ==> github-delete-repo
+
+Creates and initialises a new GitHub repository on GitHub's servers.
+
+___
+FUNCTION_INVOCATION[/misc/workflows/workflows/git/github-delete-repo.hl]:
+{
+  "name": "[STRING_VALUE]"
+}
+___
+
+## Arguments
+
+* `name` is the mandatory GitHub project name.
+ 

backend/files/misc/common-startup-files/default-files/misc/how-to-use-git-and-github.md

@@ -0,0 +1,18 @@
+How to use Git and GitHub
+
+Magic contains a whole range of function related to Git. You can find a complete list below. However, before you can use Git or GitHub, you will have to add configuration settings for it resembling the following;
+
+```json
+{
+  "magic": {
+    "git": {
+      "github": {
+        "username": "YOUR_GIT_AND_GITHUB_USERNAME",
+        "token": "github_pat_YOUR_GITHUB_TOKEN_HERE",
+        "host": "github.com"
+      }
+    },
+   /* ... rest of file ... */
+```
+
+You will need to exchange the above `username` and `token` parts. To get a token, you can go to "https://github.com/settings/personal-access-tokens" and create a new token. When you create it you should create it with access to _"All repositories"_ in addition to granting it both read and write permissions to _"Administration"_ and _"Contents"_