Skip to content

Commit

Permalink
feat: stable release changelog
Browse files Browse the repository at this point in the history
  • Loading branch information
DarthBenro008 committed Jul 29, 2021
1 parent 2c68dbe commit f7e0865
Show file tree
Hide file tree
Showing 3 changed files with 128 additions and 4 deletions.
33 changes: 33 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Changelog
All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.1.0] - 2017-06-20

## Initial Release

### Features

- Tasks
- list
- add
- delete
- show
- stats
- clear
- done
- undo
- TaskList
- create
- select
- update
- delete
- Google
- login
- logout
- status
- Battery: Shows help to setup p10k battery
90 changes: 90 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
# Contributing Guidelines

This document contains certain rules and guidelines that developers are expected to follow, while contributing to this repository.

---

## 1. Commit Messages

- Use the `-m` flag only for minor changes. The message following the `-m` flag must be of the below format :

> `<Verb>: <Action>`
Verbs oftenly used are

- add
- feat
- fix
- refactor

:white_check_mark: **Examples of valid messages:**

- add: serialisers.py for users app
- feat: validation
- fix: functionality of authentication process
- refactor: remove unwanted comments from src/auth.ts

:x: **Examples of invalid messages:**

- Idk why this is not working
- Only ui bug fixes left
- All changes done, ready for production :))

- Before opening a PR, make sure you squash all your commits into one single commit using `git rebase` (squash). Instead of having 50 commits that describe 1 feature implementation, there must be one commit that describes everything that has been done so far. You can read up about it [here](https://www.internalpointers.com/post/squash-commits-into-one-git).
> NOTE: While squashing your commits to write a new one, do not make use of `-m` flag. In this case, a vim editor window shall open. Write a title for the commit within 50-70 characters, leave a line and add an understandable description.
## 2. Issues

- Issues **MUST** be opened any time any of the following events occur:
1. You want feature enhancements.
2. You encounter bugs.
3. Code refactoring is required.
4. Test coverage should be increased.
- **Open issues with the given template only.**
- Feel free to label the issues appropriately.
- Do not remove the headings (questions in bold) while opening an issue with the given template. Simply append to it.

## 3. Branches and PRs

- No commits must be made to the `main`/`master` branch directly. The `main`/`master` branch shall only consist of the working code.
- Developers are expected to work on feature branches, and upon successful development and testing, a PR (pull request) must be opened to merge with `main`/`master`.
- A branch must be named as either as the feature being implemented, or the issue being fixed.

:white_check_mark: **Examples of valid brach names:**

- #8123 (issue number)
- OAuth (feature)
- questionsUtils (functionality of the questions)

:x: **Examples of invalid branch names**:

- ziyan-testing
- attemptToFixAuth
- SomethingRandom

## 4. Discussion Ethics

- Developers should be clear and concise while commenting on issues or PR reviews. If needed, one should provide visual reference or a code snippet for everyone involved to properly grasp the context.
- Everyone should be respectful of everyone's opinion. Any harsh/disrespectful language is **STRICTLY** prohibited and will not be tolerated under any circumstances.

## 5. Coding Ethics

- Developers are highly encouraged to use comments wherever necessary and make the code self documented.
- The project structure should be neat and organised. All folders and files should be organised semantically according to their functionality.
- The name of the folders and files should not be too long but should be as self explanatory as possible.
- Documentation shall **STRICTLY** have gender neutral terms. Instead of using "he/him" or "she/her", one should use "they/them" or "the user".

## 6. Coding Style Guidelines

Developers should aim to write clean, maintainable, scalable and testable code. If your code is not testable, that means, it's time to refactor it. The following guidelines might come in handy for this:

- Python: [Hitchiker's Guide to Python](https://docs.python-guide.org/writing/style/), [Google](https://github.com/google/styleguide/blob/gh-pages/pyguide.md)
- GoLang: [Effective-Go](https://golang.org/doc/effective_go.html)
- Django: [Django-Styleguide](https://github.com/HackSoftware/Django-Styleguide)
- JavaScript: [Airbnb](https://github.com/airbnb/javascript)
- React.JS: [Airbnb](https://github.com/airbnb/javascript/tree/master/react)
- Flutter/Dart: [Effective-Dart](https://dart.dev/guides/language/effective-dart)
- Kotlin: [Kotlin Conventions](https://kotlinlang.org/docs/reference/coding-conventions.html)
- Swift: [Swift Style Guide](https://github.com/github/swift-style-guide), [Google](https://google.github.io/swift/)
- Docker: [Dev Best Practices](https://docs.docker.com/develop/), [Dockerfile Best Practices](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)
{"mode":"full","isActive":false}
9 changes: 5 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
[![GitHub License](https://img.shields.io/github/license/aryan9600/cowin-notifier)](https://github.com/aryan9600/cowin-notifier/blob/master/LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/aryan9600/cowin-notifier/issues/new/choose)
![Twitter URL](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FDarthBenro008%2Frchore)

# rChore

> A feature packed unofficial Google Tasks CLI to boost your producitvity, written purely in Rust.
Expand Down Expand Up @@ -61,14 +62,14 @@ If you use powerlevel10k, you can type `rchore battery` to get help on installin
- Open .p10k.zsh file in your favorite editor.
- Copy the function from `rchore battery` and append it to your .p10k.zsh file
- Add rchore to either `POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS` or `POWERLEVEL9K_LEFT_PROMPT_ELEMENTS`

```bash
typeset -g POWERLEVEL9K_RIGHT_PROMPT_ELEMENTS=(
# =========================[ Line #1 ]=========================
...
...
rchore
)
````
```

## 🛠 Architecture and Structure

Expand All @@ -83,7 +84,7 @@ Spread the word to your fellows to boost producitivity for everyone!
## 🤝 Contributions

- Feel Free to Open a PR/Issue for any feature or bug(s).
- Make sure you follow the [community guidelines](https://docs.github.com/en/github/site-policy/github-community-guidelines) and read [CONTRIBUTIONS.md](https://github.com/DarthBenro008/rchore/CONTRIBUTIONS.md)!
- Make sure you follow the [community guidelines](https://docs.github.com/en/github/site-policy/github-community-guidelines) and read [CONTRIBUTING.md.md](https://github.com/DarthBenro008/rchore/CONTRIBUTING.md)!
- Feel free to open an issue to ask a question/discuss anything about rChore.
- Have a feature request? Open an Issue!

Expand Down

0 comments on commit f7e0865

Please sign in to comment.