Skip to content

Commit

Permalink
Initial content (#6)
Browse files Browse the repository at this point in the history
* Fixed workflow. PRs using main not master

* CNAME file for GitHub pages

* CNAME file for GitHub pages

* CNAME file for GitHub pages

* static/CNAME file for GitHub pages

* Fixed deployment configuration

* HTTP site

* First content

* Fixed broken images

* Fixed broken images

* Updated to HTTPS

* Updated broken images

* Fixed footer broken links

* Fixed more broken links

* Fixed more broken links v2

* Fixed more broken links v3

* Fixed more broken links v4

* Updated cloning instructions
  • Loading branch information
palisadoes authored Dec 2, 2024
1 parent 0c4fbca commit 4c7ffec
Show file tree
Hide file tree
Showing 67 changed files with 3,675 additions and 783 deletions.
50 changes: 50 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,53 @@
##########################################################
# VsCode editor
##########################################################

.vscode

##########################################################
# Vim editor
##########################################################

# Swap
[._]*.s[a-v][a-z]
!*.svg # comment out if you don't need vector files
[._]*.sw[a-p]
[._]s[a-rt-v][a-z]
[._]ss[a-gi-z]
[._]sw[a-p]

# Session
Session.vim
Sessionx.vim

# Temporary
.netrwhist
*~
# Auto-generated tag files
tags

# Persistent undo
[._]*.un~

##########################################################
# Python
##########################################################

__pycache__/
*.py[cod]
*$py.class
.env
.venv
env/
venv/
ENV/
env.bak/
venv.bak/

##########################################################
# Docusaurus
##########################################################

# Dependencies
/node_modules

Expand Down
12 changes: 0 additions & 12 deletions blog/2019-05-28-first-blog-post.md

This file was deleted.

44 changes: 0 additions & 44 deletions blog/2019-05-29-long-blog-post.md

This file was deleted.

24 changes: 0 additions & 24 deletions blog/2021-08-01-mdx-blog-post.mdx

This file was deleted.

Binary file not shown.
29 changes: 0 additions & 29 deletions blog/2021-08-26-welcome/index.md

This file was deleted.

23 changes: 0 additions & 23 deletions blog/authors.yml

This file was deleted.

19 changes: 0 additions & 19 deletions blog/tags.yml

This file was deleted.

16 changes: 16 additions & 0 deletions docs/git-guide/Git working/Feature-branch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Work on a feature branch

Working with git can be organized by creating a branch for each issue or feature.Git is designed for lightweight branching and merging. You can and should create as many branches as you’d like.

First, make sure your `develop` branch is up-to-date with Talawa upstream. [(see how)](#keep-your-fork-up-to-date)

Next from your `develop` branch,create a new branch. We recommend naming your branch a descriptive name relating to your feature or issue.

```
$ git checkout develop
Switched to branch 'develop'
$ git checkout -b issue-178-docsissue
Switched to a new branch 'issue-178-docsissue'
```

Now you are ready to work on the issue or feature.
17 changes: 17 additions & 0 deletions docs/git-guide/Git working/Fork.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
# Keep your fork up to date

You'll want to [keep your fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/syncing-a-fork) up-to-date with changes from Talawa's main repositories

First Make sure you have check out your `develop` branch

```
$ git checkout develop
Switched to branch 'develop'
```

Next is pulling the upstream and [pushing the changes](https://docs.github.com/en/get-started/using-git/pushing-commits-to-a-remote-repository) to your remote fork.Then run `git push`

```
$ git pull upstream develop
$ git push origin develop
```
40 changes: 40 additions & 0 deletions docs/git-guide/Git working/Stage changes/stage-additions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Stage additions with ```git add```

To add changes to your staging area, use ```git add <filename>```. Because ```git add``` is all about staging the changes you want to commit, you use it to add new files as well as files with changes to your staging area.

Continuing our above example, after we run ```git add docs/introduction.md```, we'll see the following from ```git status```:

```
On branch issue-178-docsissue
Changes to be committed:
(use "git reset HEAD <file>..." to unstage)
new file: docs/introduction.md
```

You can view the changes in files you have staged with ```git diff --cached```. To view changes to files you haven’t yet staged, just ```use git diff```.

If you want to add all changes in the working directory, ```use git add -A``` [(documentation)](https://git-scm.com/docs/git-add).

If you stage a file, you can undo it with ```git reset HEAD <filename>```. Here’s an example where we stage a file ```test2.md``` and then unstage it:

```
$ git add test2.md
On branch issue-234
Changes to be commited:
(use "git reset HEAD <file>..." to unstage)
new file: test2.md
$ git reset HEAD test2.md
$ git status
On branch issue-234
Untracked files:
(use "git add <file>..." to include in what will be commited)
test2.md
nothing added to commit but untracked files present (use "git add" to track)
```
5 changes: 5 additions & 0 deletions docs/git-guide/Git working/Stage changes/stage-changes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Stage changes

Files in Git can have three possible states: committed, modified, and staged.

To prepare a commit, first add the files with changes that you want to include in your commit to your staging area. You add both new files and existing ones. You can also remove files from staging when necessary.
29 changes: 29 additions & 0 deletions docs/git-guide/Git working/Stage changes/stage-deletions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Stage deletions with git rm

To remove existing files from your repository, use ```git rm``` [documentation](https://git-scm.com/docs/git-rm). This command can either stage the file for removal from your repository AND delete it from your working directory or just stage the file for deletion and leave it in your working directory.

To stage a file for deletion and remove it from your working directory, ```use git rm <filename>```:

```
$ git rm --cached test4.md
rm 'test4.md'
$ git status
On branch issue-100
Changes to be commited:
(use "git reset HEAD <file>..." to unstage)
deleted: test4.md
$ ls test4.md
test4.md
```

If you stage a file for deletion with the ```--cached option```, and haven’t yet run ```git commit```, you can undo it with ```git reset HEAD <filename>```:

```
$ git reset HEAD test4.md
```

Unfortunately, you can’t restore a file deleted with ```git rm``` if you didn’t use the ```--cache``` option. However, ```git rm``` only deletes files it knows about. Files you have never added to Git won’t be deleted.
23 changes: 23 additions & 0 deletions docs/git-guide/Git working/Stage changes/status.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Get status of working directory

To see what files in the working directory have changes that have not been staged, use ```git status```.

If you have no changes in the working directory, you’ll see something like this:

```
$ git status
on branch issue-178-docsissue
nothing to commit, working directory clean
```

If you have unstaged changes, you’ll see something like this:

```
On branch issue-178-docsissue
Untracked files:
(use "git add <file>..." to include in what will be committed)
docs/introduction.md
nothing added to commit but untracked files present (use "git add" to track)
```
29 changes: 29 additions & 0 deletions docs/git-guide/Git working/branch.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Know what branch you're currently working on

When working with Git, it's crucial to Know which branch you have currently checked out, Most of the Git commands implicitly operate on the current branch. you can determine the currently checked out branch in several ways

One of the most common way is with [git status](https://git-scm.com/docs/git-status)

```
$ git status
on branch git-demo
nothing to commit, working directory clean
```

Another is with [git branch](https://git-scm.com/docs/git-branch) which will display all local branches, with a star icon next to the current branch:

```
$ git branch
* git-demo
main
```

You can see more detailed information about your branches, including remote branches, to do the same use, ```git branch -vva```

```
$ git branch -vva
develop 3ca006a [origin/develop] Updating talawa documentation as new PR merged into talawa:automated-docs
* docs 3ca006a Updating talawa documentation as new PR merged into talawa:automated-docs
remotes/origin/HEAD -> origin/develop
remotes/origin/develop 3ca006a Updating talawa documentation as new PR merged into talawa:automated-docs
```
16 changes: 16 additions & 0 deletions docs/git-guide/Git working/commit-changes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Commit changes

Once you've staged all your changes, you're ready to commit. You can do this with ``` git commit -m "My commit message." ``` to include a commit message.

Here’s an example of committing with the ```-m``` for a one-line commit message:

```
$ git commit -m "Add few lines to docs"
[issue-178-docsissue] Add a few lines to docs.
1 file changed, 1 insertion(+)
created mode 100644 test.md
```

You can also use git commit without the ```-m``` option and your editor to open, allowing you to easily draft a multi-line commit message.

How long your commit message should be depends on where you are in your work. Using short, one-line messages for commits related to in-progress work makes sense. For a commit that you intend to be final or that encompasses a significant amount or complex work, you should include a longer message.
Loading

0 comments on commit 4c7ffec

Please sign in to comment.