From b8d92e84eb4d00b462a36bd2e3f3c79b8e4de089 Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 01:41:48 +0530
Subject: [PATCH 1/7] Create DOCUMENTATION.md
---
DOCUMENTATION.md | 271 +++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 271 insertions(+)
create mode 100644 DOCUMENTATION.md
diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
new file mode 100644
index 00000000..b1a06d75
--- /dev/null
+++ b/DOCUMENTATION.md
@@ -0,0 +1,271 @@
+
+# Introduction
+
+
+GitConvex is a web app for managing your git repositories. It is supported by Linux, Mac OS and Windows. The [latest version](https://github.com/neel1996/gitconvex-package/releases) of GitConvex supports git features such as initializing and tracking a git repo, staging and unstaging changes, committing changes, pushing changes to selected remote and so on.
+The main goal of this platform is to act as a web based alternative for Github desktop, but we are still in the starting stages, so we are not completely there yet (baby steps, right?)
+## Requirements
+1. Node JS (Version 12.0+)
+
+2. Git (Version 2.20+)
+
+
+
+## Download Options
+
+
+- **Option-1:** Directly clone the repo from github
+
+`git clone https://github.com/neel1996/gitconvex-package`
+
+
+
+- **Option-2** Downloading the zip file from the [releases](https://github.com/neel1996/gitconvex-package/releases).
+
+
+
+- **Option-3** GitConvex is also available on `npm`. Install the package globally to run it directly from the command line,
+
+
+
+`npm i -g @itassistors/gitconvex`
+
+
+
+This will install **gitconvex** as a global module and it can be started straight away from the command line with `gitconvex` command
+
+
+
+```
+
+$ gitconvex
+
+
+
+INFO: Checking for config file
+
+INFO: Config file is present
+
+INFO: Reading from config file /usr/lib/node_modules/@itassistors/gitconvex/env_config.json
+
+GitConvex API connected!
+
+
+
+Checking data file availability...
+
+INFO: Data file /usr/lib/node_modules/@itassistors/gitconvex/database/repo-datastore.json is present and it will be used as the active data file!
+
+
+
+You can change this under the settings menu
+
+
+
+Gitconvex is running on port 9001
+
+
+
+Open http://localhost:9001/ to access gitconvex
+
+```
+
+
+
+
+## Setup
+
+If either download **Option-1** or **Option-2** is followed, then the following steps need to be followed to setup GitConvex
+
+
+
+1. For installing all dependencies,
+
+`` $npm install ``
+
+
+
+2. To start a server, either use normal node command
+
+`` $node server.js ``
+
+
+
+or use `pm2` by downloading it from npm - `npm i -g pm2` and start the module by executing the following command,
+
+`pm2 start ecosystem.config.js`
+
+
+
+## Features available
+
+- Visualizing basic repo stats such as active branch, active remotes, number of files tracked etc
+
+- Tracking modified files
+
+- Creating new branches (provided there are no diverging changes)
+
+- Initializing git inside a new repo and adding it to the platform tracker on the go
+
+- File difference tracker with syntax highlighting for the [supported languages](language).
+
+- Commit log viewer
+
+- Basic git operations such as staging, un-staging, committing and pushing to remote repo.
+
+
+
+## How to use
+
+
+
+### Left Pane Menu
+
+
+
+- **Repositories** - To check tracked files changes, line based changes with syntax highlighting and git operations (staging, unstaging, commiting changes and pushing changed to remote)
+
+- **Settings** - To check and edit internal data file, to remove a repo from gitconvex and to update the active port
+
+- **Help** - Includes documentation link and various options to report an issue or to submit feedback
+
+
+
+### Adding a new repo
+
+- Use "+" at the bottom right corner to add a repo.
+
+
+
+
+
+- Enter repo name and paste the repo path. If the folder is not a git repo then check the "*Check this if the folder is not a git repo*" checkbox to initialize git.
+
+
+
+
+
+- The newly added repo will be displayed as a card in the dashboard
+
+
+
+### Repo Details
+
+- Click on the repo card to get the following details about the repo
+
+```
+
+- The list of branches
+
+- Commit logs
+
+- Latest commit
+
+- Active branch and available local branches
+
+- Remote repo URL and host
+
+- Files and folders tracked by git
+
+```
+
+The repo detail view also provides features for performing the following git operations,
+
+```
+
+- Adding a new branch
+
+- Pulling changes from remote
+
+- Fetching changes from remote
+
+- Adding a new remote repo
+
+```
+
+
+
+
+
+
+
+
+
+#### Add new branch
+
+
+
+
+
+Note: In a newly initialized git repo, the newly added branch will be considered by git only after a initial commit
+
+
+
+- Next, left pane consists of repositories, settings and help. In "repositories" choose a saved repo. This module has three sections : File view, Git difference and Git operation. The header portion shows chosen repo name, active branch, number of tracked files and commits.
+
+- File view shows the new/Untracked/Modified/deleted files.
+
+
+
+- Git operations module consists of three basic git operations( Stage all changes, commit changes, push to remote ). Below this file status is display and the files can be staged with add action or click on "stage all changes" to stage all the untracked files from the chosen repo.
+
+
+
+
+
+- After add operation all staged files can be removed immediately if you wish to, else ignore it. Reload the page to see the difference in "File View".
+
+
+
+- All staged files can be committed using "Commit changes" module. After commit changes reload the page to see active branch name, number of tracked files and number of commits.
+
+
+
+
+
+- After **commit changes** operation,
+
+
+
+
+
+
+
+- "Push to remote" module pushes all commits to the remote host. If there is no remote in the chosen repo then ignore this module. After the push to remote is completed, check the remote host to see the pushed folder/file.
+
+with Remote(Git Hub)
+
+
+
+If you try to "push to remote" without having a remote host, "push failed" error message will be displayed.
+
+
+
+
+
+
+In "Git Difference" click on the modified file(s) to see the difference.
+
+
+
+- "Stage all changes" and "commit changes" for applying a change.
+
+
+
+- Settings in the left pane has three sections( Server data file, saved repos, Active GitConvex port number ).
+
+
+
+
+
+
+
+- Server data file stores repo details. The data file can be updated. The data file must be an accessible JSON file with read / write permissions set to it. Also make sure you enter the full path for the file. E.g: /opt/my_data/data-file.json
+
+- In the saved repos section, added repo(s) can be deleted permanently from GitConvex.
+
+- The port number can be updated but make sure to restart the app and to change the port in the URL after updating it.
+
+- Visit help section if you're facing an issue or need any help. If you have any queries discuss it in "Discord" or report an issue in GitHub.
+
+
From cdf195f8a03efb3ee012d9fd9ac0734e2ba5cbd7 Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 18:24:51 +0530
Subject: [PATCH 2/7] Revised documentation for GitConvex
---
DOCUMENTATION.md | 194 ++++++++---------------------------------------
1 file changed, 30 insertions(+), 164 deletions(-)
diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index b1a06d75..885d5421 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -1,271 +1,137 @@
-
# Introduction
-
-
GitConvex is a web app for managing your git repositories. It is supported by Linux, Mac OS and Windows. The [latest version](https://github.com/neel1996/gitconvex-package/releases) of GitConvex supports git features such as initializing and tracking a git repo, staging and unstaging changes, committing changes, pushing changes to selected remote and so on.
The main goal of this platform is to act as a web based alternative for Github desktop, but we are still in the starting stages, so we are not completely there yet (baby steps, right?)
## Requirements
-1. Node JS (Version 12.0+)
-
-2. Git (Version 2.20+)
-
-
-
+1. [Node JS](https://nodejs.org/en/) (Version 12.0+)
+2. [Git](https://git-scm.com/) (Version 2.20+)
## Download Options
-
-
- **Option-1:** Directly clone the repo from github
-
`git clone https://github.com/neel1996/gitconvex-package`
-
-
- **Option-2** Downloading the zip file from the [releases](https://github.com/neel1996/gitconvex-package/releases).
-
-
-- **Option-3** GitConvex is also available on `npm`. Install the package globally to run it directly from the command line,
-
-
-
+- **Option-3** GitConvex is also available on `npm`. Install the package globally to run it directly from the command line
`npm i -g @itassistors/gitconvex`
-
-
This will install **gitconvex** as a global module and it can be started straight away from the command line with `gitconvex` command
-
-
-
```
-
$ gitconvex
-
-
INFO: Checking for config file
-
INFO: Config file is present
-
INFO: Reading from config file /usr/lib/node_modules/@itassistors/gitconvex/env_config.json
-
GitConvex API connected!
-
-
Checking data file availability...
-
INFO: Data file /usr/lib/node_modules/@itassistors/gitconvex/database/repo-datastore.json is present and it will be used as the active data file!
-
-
-
You can change this under the settings menu
-
-
-
Gitconvex is running on port 9001
-
-
-
Open http://localhost:9001/ to access gitconvex
-
```
-
-
-
-
## Setup
-If either download **Option-1** or **Option-2** is followed, then the following steps need to be followed to setup GitConvex
-
-
-
+If either download **Option-1** or **Option-2** is opted, then the following steps need to be followed to setup GitConvex
1. For installing all dependencies,
-
`` $npm install ``
-
-
-2. To start a server, either use normal node command
-
+2. To start the server, either use normal node command
`` $node server.js ``
-
-
-
or use `pm2` by downloading it from npm - `npm i -g pm2` and start the module by executing the following command,
-
`pm2 start ecosystem.config.js`
-
-
## Features available
-
- Visualizing basic repo stats such as active branch, active remotes, number of files tracked etc
-
- Tracking modified files
-
- Creating new branches (provided there are no diverging changes)
-
- Initializing git inside a new repo and adding it to the platform tracker on the go
-
- File difference tracker with syntax highlighting for the [supported languages](language).
-
- Commit log viewer
-
- Basic git operations such as staging, un-staging, committing and pushing to remote repo.
-
-
## How to use
-
-
### Left Pane Menu
-
-
- **Repositories** - To check tracked files changes, line based changes with syntax highlighting and git operations (staging, unstaging, commiting changes and pushing changed to remote)
-
-- **Settings** - To check and edit internal data file, to remove a repo from gitconvex and to update the active port
-
-- **Help** - Includes documentation link and various options to report an issue or to submit feedback
-
-
+- **Settings** - To check and edit internal data file, to remove a repo from gitconvex and to update the active port.
+- **Help** - Includes documentation link and various options to report an issue or to submit feedback.
### Adding a new repo
-
- Use "+" at the bottom right corner to add a repo.
-
-
-
- Enter repo name and paste the repo path. If the folder is not a git repo then check the "*Check this if the folder is not a git repo*" checkbox to initialize git.
-
-
-
- The newly added repo will be displayed as a card in the dashboard
-
-
+
### Repo Details
-
- Click on the repo card to get the following details about the repo
-
```
-
- The list of branches
-
- Commit logs
-
- Latest commit
-
- Active branch and available local branches
-
- Remote repo URL and host
-
- Files and folders tracked by git
-
```
-
The repo detail view also provides features for performing the following git operations,
-
```
-
- Adding a new branch
-
- Pulling changes from remote
-
- Fetching changes from remote
-
- Adding a new remote repo
-
```
-
-
-
-
-
#### Add new branch
-
-
-
Note: In a newly initialized git repo, the newly added branch will be considered by git only after a initial commit
-
-
-- Next, left pane consists of repositories, settings and help. In "repositories" choose a saved repo. This module has three sections : File view, Git difference and Git operation. The header portion shows chosen repo name, active branch, number of tracked files and commits.
-
-- File view shows the new/Untracked/Modified/deleted files.
+## Repositoru Menu
+- The **Repository** menu has three sections : File view, Git difference and Git operation, which will be displayed based on the selected repo.
+### File View
+- File view shows the New/Untracked/Modified/Deleted files.
-- Git operations module consists of three basic git operations( Stage all changes, commit changes, push to remote ). Below this file status is display and the files can be staged with add action or click on "stage all changes" to stage all the untracked files from the chosen repo.
-
-
-
+### Git Operations
+- Git operations module consists of three basic git operations( Stage all changes, commit changes, push to remote ). Below this file status is display and the files can be staged with add action or click on "stage all changes" to stage all the files from the chosen repo.
-- After add operation all staged files can be removed immediately if you wish to, else ignore it. Reload the page to see the difference in "File View".
-
+- The staged files can be removed individually or it can be removed all at once.
-- All staged files can be committed using "Commit changes" module. After commit changes reload the page to see active branch name, number of tracked files and number of commits.
-
-
-
+- The staged changes can be comitted using the **Commit changes** option. This will display a pop-up with all the staged files and it requires a commit message to successfully commit the changes.THe commit messages can either be a single line message or a multi-line message
-- After **commit changes** operation,
-
-
-
-
-
-
-
-- "Push to remote" module pushes all commits to the remote host. If there is no remote in the chosen repo then ignore this module. After the push to remote is completed, check the remote host to see the pushed folder/file.
-
-with Remote(Git Hub)
-
+- **Push to remote** option pushes all commits to the selected remote host. The pop-up displayed will display the commits which are in queue to be pushed to the remote repository
-If you try to "push to remote" without having a remote host, "push failed" error message will be displayed.
-
-
-
+This section will let you know if the selected remote is not valid or if the push operation fails
-
-In "Git Difference" click on the modified file(s) to see the difference.
+### Git Difference
-
-
-- "Stage all changes" and "commit changes" for applying a change.
-
-
+In "Git Difference" click on the modified file(s) to see the difference. The platform has syntax highlighting available for a limited set of [languages](LANGUAGES.md)
+
+## Settings
- Settings in the left pane has three sections( Server data file, saved repos, Active GitConvex port number ).
+
-
-
-
-
-
-
-- Server data file stores repo details. The data file can be updated. The data file must be an accessible JSON file with read / write permissions set to it. Also make sure you enter the full path for the file. E.g: /opt/my_data/data-file.json
+- Server data file stores repo details such as the repo path, timestamp and the unique ID assigned to each repo. The data file must be an accessible JSON file with read / write permissions set to it. Also make sure you enter the full path for the file. E.g: /opt/my_data/data-file.json
+- In the saved repos section, added repo(s) can be deleted permanently from GitConvex.
-- In the saved repos section, added repo(s) can be deleted permanently from GitConvex.
+>Note that, this will only remove the repo from gitconvex records andit will not perform an actual folder delete operation
-- The port number can be updated but make sure to restart the app and to change the port in the URL after updating it.
+- The port number can be updated to an available alternate port. Make sure that the port is not in use. The app needs to be restarted for the port change to take effect.
-- Visit help section if you're facing an issue or need any help. If you have any queries discuss it in "Discord" or report an issue in GitHub.
+## Help
-
+- Visit help section if you're facing an issue or need any help. If you have any queries or feedback, then discuss it in "Discord" or report an issue in GitHub.
+
From 5d12c73501b89a44eebbca8feb5e31924160135b Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 18:28:59 +0530
Subject: [PATCH 3/7] Supported languages file
---
LANGUAGES.md | 24 ++++++++++++++++++++++++
1 file changed, 24 insertions(+)
create mode 100644 LANGUAGES.md
diff --git a/LANGUAGES.md b/LANGUAGES.md
new file mode 100644
index 00000000..bf855125
--- /dev/null
+++ b/LANGUAGES.md
@@ -0,0 +1,24 @@
+## Languages
+js : JavaScript
+java : Java
+py : Python
+c : C
+cpp : C++
+go : Go
+rust : Rust
+ts : TypeScript
+dart : Dart
+php : PHP
+html : Markup
+json : JSON
+xml : Markup
+yaml : YAML
+yml : YML
+rb : Ruby
+jsx : JSX
+kt : Kotlin
+ktm : Kotlin
+kts : Kotlin
+cs : C#
+vb : Visual Basics
+css : CSS
From e2576b82d9c0a7bd5a4ee82616b6d4d22b83b0df Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 18:30:26 +0530
Subject: [PATCH 4/7] Language.md new patch
---
LANGUAGES.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/LANGUAGES.md b/LANGUAGES.md
index bf855125..ec540337 100644
--- a/LANGUAGES.md
+++ b/LANGUAGES.md
@@ -13,7 +13,7 @@ html : Markup
json : JSON
xml : Markup
yaml : YAML
-yml : YML
+yml : YML
rb : Ruby
jsx : JSX
kt : Kotlin
From 4a48465c2313ee81226cafbe45cb2c935bfb8231 Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 18:34:33 +0530
Subject: [PATCH 5/7] Updated languages markdown file link
---
DOCUMENTATION.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index 885d5421..f66e544f 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -44,7 +44,7 @@ or use `pm2` by downloading it from npm - `npm i -g pm2` and start the module by
- Tracking modified files
- Creating new branches (provided there are no diverging changes)
- Initializing git inside a new repo and adding it to the platform tracker on the go
-- File difference tracker with syntax highlighting for the [supported languages](language).
+- File difference tracker with syntax highlighting for the [supported languages](LANGUAGES.md).
- Commit log viewer
- Basic git operations such as staging, un-staging, committing and pushing to remote repo.
From 9f2c4c232b1b963a5dcf25d1f7075d28396e83db Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 22:11:17 +0530
Subject: [PATCH 6/7] Formatted languages
---
LANGUAGES.md | 50 +++++++++++++++++++++++++++-----------------------
1 file changed, 27 insertions(+), 23 deletions(-)
diff --git a/LANGUAGES.md b/LANGUAGES.md
index ec540337..baed0e35 100644
--- a/LANGUAGES.md
+++ b/LANGUAGES.md
@@ -1,24 +1,28 @@
## Languages
-js : JavaScript
-java : Java
-py : Python
-c : C
-cpp : C++
-go : Go
-rust : Rust
-ts : TypeScript
-dart : Dart
-php : PHP
-html : Markup
-json : JSON
-xml : Markup
-yaml : YAML
-yml : YML
-rb : Ruby
-jsx : JSX
-kt : Kotlin
-ktm : Kotlin
-kts : Kotlin
-cs : C#
-vb : Visual Basics
-css : CSS
+
+|Extensions|Languages|
+|-|-|
+|**js**|JavaScript|
+|**java**|Java|
+|**py**|Python|
+|**c**|C|
+|**cp**|C++|
+|**go**|Go|
+|**rust**|Rust|
+|**ts**|TypeScript|
+|**dart**|Dart|
+|**php**|PHP|
+|**html**|Markup|
+|**json**|JSON|
+|**xml**|Markup|
+|**yaml**|YAML|
+|**yml**|YML|
+|**rb**|Ruby|
+|**jsx**|JSX|
+|**kt**|Kotlin|
+|**ktm**|Kotlin|
+|**kts**|Kotlin|
+|**cs**|C#|
+|**vb**|Visual Basics|
+|**css**|CSS|
+
From 6323f60423c0febaa6415813c16bcebb99b3f967 Mon Sep 17 00:00:00 2001
From: Nageswari SV <65342122+Nageswari-droid@users.noreply.github.com>
Date: Sun, 12 Jul 2020 22:21:05 +0530
Subject: [PATCH 7/7] Revised documentation
---
DOCUMENTATION.md | 80 +++++++++++++++++++++++++++---------------------
1 file changed, 45 insertions(+), 35 deletions(-)
diff --git a/DOCUMENTATION.md b/DOCUMENTATION.md
index f66e544f..5be84920 100644
--- a/DOCUMENTATION.md
+++ b/DOCUMENTATION.md
@@ -1,19 +1,29 @@
# Introduction
-GitConvex is a web app for managing your git repositories. It is supported by Linux, Mac OS and Windows. The [latest version](https://github.com/neel1996/gitconvex-package/releases) of GitConvex supports git features such as initializing and tracking a git repo, staging and unstaging changes, committing changes, pushing changes to selected remote and so on.
-The main goal of this platform is to act as a web based alternative for Github desktop, but we are still in the starting stages, so we are not completely there yet (baby steps, right?)
+GitConvex is a web app for managing your git repositories. It is supported by Linux, Mac OS and Windows. The [latest version] (https://github.com/neel1996/gitconvex-package/releases) of GitConvex supports git features such as initializing and tracking a git repo, staging and unstaging changes, committing changes, pushing changes to the selected remote and so on.
+The main goal of this platform is to act as a web-based alternative for Github desktop, but we are still in the starting stages, so we are not completely there yet (baby steps, right?)
+## Table of Contents
+[Requirements](#requirements)
+[Download Options](#download-options)
+[Setup](#setup)
+[Features available](#features-available)
+[How to use](#how-to-use)
+- [Adding a new repo](#adding-a-new-repo)
+- [Repo Details](#repo-details)
+- [Add a new branch](#add-new-branch)
+
## Requirements
1. [Node JS](https://nodejs.org/en/) (Version 12.0+)
2. [Git](https://git-scm.com/) (Version 2.20+)
## Download Options
-- **Option-1:** Directly clone the repo from github
+- **Option-1:** Directly clone the repo from GitHub
`git clone https://github.com/neel1996/gitconvex-package`
-- **Option-2** Downloading the zip file from the [releases](https://github.com/neel1996/gitconvex-package/releases).
+- **Option-2:** Downloading the zip file from the [releases](https://github.com/neel1996/gitconvex-package/releases).
-- **Option-3** GitConvex is also available on `npm`. Install the package globally to run it directly from the command line
+- **Option-3:** GitConvex is also available on `npm`. Install the package globally to run it directly from the command line
`npm i -g @itassistors/gitconvex`
-This will install **gitconvex** as a global module and it can be started straight away from the command line with `gitconvex` command
+This will install **GitConvex** as a global module and it can be started straight away from the command line with `gitconvex` command
```
$ gitconvex
@@ -25,8 +35,8 @@ GitConvex API connected!
Checking data file availability...
INFO: Data file /usr/lib/node_modules/@itassistors/gitconvex/database/repo-datastore.json is present and it will be used as the active data file!
You can change this under the settings menu
-Gitconvex is running on port 9001
-Open http://localhost:9001/ to access gitconvex
+GitConvex is running on port 9001
+Open http://localhost:9001/ to access GitConvex
```
## Setup
@@ -44,7 +54,7 @@ or use `pm2` by downloading it from npm - `npm i -g pm2` and start the module by
- Tracking modified files
- Creating new branches (provided there are no diverging changes)
- Initializing git inside a new repo and adding it to the platform tracker on the go
-- File difference tracker with syntax highlighting for the [supported languages](LANGUAGES.md).
+- File difference tracker with syntax highlighting for the [supported languages] (LANGUAGES.md).
- Commit log viewer
- Basic git operations such as staging, un-staging, committing and pushing to remote repo.
@@ -52,19 +62,19 @@ or use `pm2` by downloading it from npm - `npm i -g pm2` and start the module by
### Left Pane Menu
-- **Repositories** - To check tracked files changes, line based changes with syntax highlighting and git operations (staging, unstaging, commiting changes and pushing changed to remote)
-- **Settings** - To check and edit internal data file, to remove a repo from gitconvex and to update the active port.
+- **Repositories** - To check tracked files changes, line-based changes with syntax highlighting and git operations (staging, un-staging, committing changes and pushing changed to remote)
+- **Settings** - To check and edit internal data file, to remove a repo from GitConvex and to update the active port.
- **Help** - Includes documentation link and various options to report an issue or to submit feedback.
### Adding a new repo
- Use "+" at the bottom right corner to add a repo.
-
+
- Enter repo name and paste the repo path. If the folder is not a git repo then check the "*Check this if the folder is not a git repo*" checkbox to initialize git.
-
+
- The newly added repo will be displayed as a card in the dashboard
-
+
### Repo Details
- Click on the repo card to get the following details about the repo
@@ -83,55 +93,55 @@ The repo detail view also provides features for performing the following git ope
- Fetching changes from remote
- Adding a new remote repo
```
-
+
-
+
#### Add new branch
-
+
-Note: In a newly initialized git repo, the newly added branch will be considered by git only after a initial commit
+Note: In a newly initialized git repo, the newly added branch will be considered by git only after an initial commit
-## Repositoru Menu
-- The **Repository** menu has three sections : File view, Git difference and Git operation, which will be displayed based on the selected repo.
+## Repository Menu
+- The **Repository** menu has three sections: **File view, Git difference and Git operations**, which will be displayed based on the selected repo.
### File View
- File view shows the New/Untracked/Modified/Deleted files.
-
+
### Git Operations
-- Git operations module consists of three basic git operations( Stage all changes, commit changes, push to remote ). Below this file status is display and the files can be staged with add action or click on "stage all changes" to stage all the files from the chosen repo.
-
+- Git operations module lets you handle three basic git operations (**Stage all changes, commit changes, push to remote**). Below this option, the files will be displayed and the files can be staged individually using the "Add" button or as a whole using the "stage all changes".
+
- The staged files can be removed individually or it can be removed all at once.
-
+
-- The staged changes can be comitted using the **Commit changes** option. This will display a pop-up with all the staged files and it requires a commit message to successfully commit the changes.THe commit messages can either be a single line message or a multi-line message
-
+- The staged changes can be committed using the **Commit changes** option. This will display a pop-up with all the staged files and it requires a commit message to successfully commit the changes. The commit messages can either be a single line message or a multi-line message
+
- **Push to remote** option pushes all commits to the selected remote host. The pop-up displayed will display the commits which are in queue to be pushed to the remote repository
-
+
This section will let you know if the selected remote is not valid or if the push operation fails
-
+
### Git Difference
-In "Git Difference" click on the modified file(s) to see the difference. The platform has syntax highlighting available for a limited set of [languages](LANGUAGES.md)
-
+In "Git Difference" click on the modified file to see the difference. The platform has syntax highlighting available for a limited set of [languages](LANGUAGES.md)
+
## Settings
-- Settings in the left pane has three sections( Server data file, saved repos, Active GitConvex port number ).
-
+- Settings in the left pane has three sections (Server data file, saved repos, Active GitConvex port number).
+
- Server data file stores repo details such as the repo path, timestamp and the unique ID assigned to each repo. The data file must be an accessible JSON file with read / write permissions set to it. Also make sure you enter the full path for the file. E.g: /opt/my_data/data-file.json
- In the saved repos section, added repo(s) can be deleted permanently from GitConvex.
->Note that, this will only remove the repo from gitconvex records andit will not perform an actual folder delete operation
+>Note that, this will only remove the repo from GitConvex records and it will not perform an actual folder delete operation
- The port number can be updated to an available alternate port. Make sure that the port is not in use. The app needs to be restarted for the port change to take effect.
-## Help
+## Help and Support
- Visit help section if you're facing an issue or need any help. If you have any queries or feedback, then discuss it in "Discord" or report an issue in GitHub.
-
+