Skip to content

Commit 9fac612

Browse files
committed
docs: update readme and contributing
1 parent 60a3292 commit 9fac612

File tree

2 files changed

+26
-148
lines changed

2 files changed

+26
-148
lines changed

CONTRIBUTING.md

Lines changed: 13 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,34 @@
1-
# Contributing to Theme Tool
1+
# Contributing Code
22

33
Thank you for your interest in participating!
44

5-
There are many ways to contribute, beyond writing code or programming, by: logging bugs, reporting issues, and creating suggestions. To do so, please [create a ticket](https://github.com/shabados/theme-tool/issues/new/choose) in our issue tracker. See other ways to [Contribute](README.md#Contributing) or give [Feedback](README.md#Feedback).
5+
There are many ways to contribute, beyond writing code or programming, by: asking questions, reporting bugs, and suggesting features. To do so, please log a [new issue](https://github.com/shabados/theme-tool/issues/new).
66

7-
This document is for developers or programmers contributing to the source code of Theme Tool.
7+
**This document is for developers or programmers contributing to the source code.**
88

9-
**Table of Contents**
9+
## Get Started
1010

11-
- [Getting Started](#getting-started)
12-
- [Prerequisites](#prerequisites)
13-
- [Build](#build)
14-
- [Start](#start)
15-
- [Workflow](#workflow)
16-
- [Coding Guidelines](#coding-guidelines)
17-
- [Scope](#scope)
18-
- [Thank you](#thank-you)
19-
20-
## Getting Started
21-
22-
If you wish to better understand how `theme-tool` works or want to debug an issue: get the source, build it, and run it locally.
23-
24-
### Prerequisites
25-
26-
In order to download necessary tools, clone the repository, and install dependencies, you'll need network access.
27-
28-
You'll need the following:
11+
**Prerequisites**
2912

3013
- [Git](https://git-scm.com/)
31-
- [Node.JS](https://nodejs.org) (If you need to manage multiple Node.JS versions, [use a node version manager](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) to install)
14+
- [Node.JS](https://nodejs.org)
15+
16+
**Development**
3217

33-
Get the source code of `theme-tool` repo:
18+
Get the source code of `theme-tool` repo. Our recommended approach is to use the [`gh` cli tool from GitHub](https://cli.github.com/). This will fork the repo to your GitHub account (if not already), clone it to your local machine, and set the appropriate remotes for origin and upstream with the above command.
3419

3520
```shell
3621
gh repo fork shabados/theme-tool --clone=true
3722
```
3823

39-
**PROTIP**: Use the [`gh` cli tool from GitHub](https://cli.github.com/) to fork the repo to your GitHub account (if not already), clone it to your local machine, and set the appropriate remotes for origin and upstream with the above command.
40-
41-
### Build
42-
4324
Run `npm i` in the root directory.
4425

45-
### Start
46-
47-
```shell
48-
npm start
49-
```
50-
51-
This will launch Theme Tool on [port `3000`](https://localhost:3000).
52-
53-
## Workflow
54-
55-
The workflow of development (or Git Flow) is to [choose/create an issue](https://github.com/shabados/theme-tool/issues) to work on, [create a feature branch](https://github.com/shabados/.github/wiki/How-to-Contribute#branches), and [submit a pull request](https://github.com/shabados/.github/wiki/How-to-Contribute#pull-requests).
56-
57-
**PROTIP**: Read more about our workflow (issue tracking, branching, and pull requests) in the [How To Contribute wiki article](https://github.com/shabados/.github/wiki/How-to-Contribute).
58-
59-
### Coding Guidelines
60-
61-
Please see the [wiki](https://github.com/shabados/.github/wiki/How-to-Contribute#coding-guidelines) for Coding Guidelines ([Names](https://github.com/shabados/.github/wiki/How-to-Contribute#41-names), [Comments](https://github.com/shabados/.github/wiki/How-to-Contribute#42-comments), [Style](https://github.com/shabados/.github/wiki/How-to-Contribute#43-style), [Linting](https://github.com/shabados/.github/wiki/How-to-Contribute#44-linting), and [Commit Messages](https://github.com/shabados/.github/wiki/How-to-Contribute#45-commit-messages)).
26+
Use `npm start` to launch Theme Tool on [port `3000`](https://localhost:3000).
6227

63-
### Scope
64-
65-
To be used in [commit messages](https://github.com/shabados/.github/wiki/How-to-Contribute#45-commit-messages).
66-
67-
Usage:
68-
69-
```shell
70-
<type>(<scope>): <subject>
71-
```
28+
## Contributing
7229

73-
There are no scopes for this repo.
30+
Please see our organization docs on [contributing](https://docs.shabados.com/community/). These cover important aspects including workflow (how to submit a PR), coding guidelines (how to write a commit message), and project management (latest/next release information).
7431

7532
## Thank you
7633

77-
Your contributions to open source, large or small, make great projects like this possible. Thank you for taking the time to participate in this project.
34+
Your contributions to open source, large or small, make great projects like this possible. Thank you for taking the time to participate in this project!

README.md

Lines changed: 13 additions & 92 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,21 @@
1-
<img src="https://raw.githubusercontent.com/shabados/presenter/dev/resources/icon.png" width="128" alt="Shabad OS">
2-
31
# Theme Tool
42

53
Overlay generator for Shabad OS Presenter. [Create a custom live stream overlay >](https://themes.shabados.com/)
64

7-
[![Release][release-image]][release-url]
8-
[![Next Release][next-image]][next-url]
5+
[![Build and Deploy](https://github.com/shabados/theme-tool/actions/workflows/deploy.yml/badge.svg?branch=master)](https://github.com/shabados/theme-tool/actions/workflows/deploy.yml)
96
<a href="https://vercel.com/?utm_source=ShabadOS&utm_campaign=oss">
10-
<img src="https://www.datocms-assets.com/31049/1618983297-powered-by-vercel.svg" width="100" alt="Powered by Vercel"/>
7+
<img src="https://www.datocms-assets.com/31049/1618983297-powered-by-vercel.svg" height="20" alt="Powered by Vercel"/>
118
</a>
129

13-
- [Introduction](#introduction)
14-
- [Features](#features)
15-
- [Screenshots](#screenshots)
16-
- [Changing text color in Theme Tool](#changing-text-color-in-theme-tool)
17-
- [Viewing Overlay settings in Presenter](#viewing-overlay-settings-in-presenter)
18-
- [Example Live Stream with Overlay captions](#example-live-stream-with-overlay-captions)
19-
- [Community](#community)
20-
- [Contributing](#contributing)
21-
- [People](#people)
22-
- [Feedback](#feedback)
23-
- [Related Projects](#related-projects)
24-
- [Code of Conduct](#code-of-conduct)
25-
- [License](#license)
26-
27-
## Introduction
28-
29-
The Shabad OS Theme Tool is an open source project with ongoing development, project management, and marketing made possible entirely by the support and dedication of unpaid volunteers.
10+
## About
3011

3112
This web app allows users to customize and generate overlays in Shabad OS Presenter. Overlays are in sync with the presenter, so what is displayed there will also show up in the overlay. Overlays should be used in live streaming software to add gurbani and/or english, hindi, punjabi translations / pronunciations.
3213

3314
See:
3415

35-
- [Our Website][website-url]
36-
- [How to install Presenter](https://tutorials.shabados.com/tutorials/1.0.0/basics/install.html)
37-
- [How to add live stream captions](https://tutorials.shabados.com/tutorials/1.0.0/overlay/add-live-streaming-captioning.html)
16+
- [Installing Shabad OS Presenter](https://docs.shabados.com/presenter/guides/installing-shabad-os-presenter)
17+
- [Configuring Live Stream Captions](https://docs.shabados.com/presenter/guides/configuring-live-stream-captions)
18+
- [Importing an overlay theme](https://docs.shabados.com/presenter/guides/importing-an-overlay-theme)
3819

3920
### Features
4021

@@ -60,76 +41,16 @@ See:
6041

6142
## Community
6243

63-
Get updates on Shabad OS and chat with the project maintainers and community members.
64-
65-
- [![Instagram][instagram-image]][instagram-url] Follow Shabad OS on Instagram
66-
- [![Twitter][twitter-image]][twitter-url] Follow Shabad OS on Twitter.
67-
- [![Chat][chat-image]][chat-url] Join the official Slack channel.
68-
69-
## Contributing
70-
71-
There are multiple ways to contribute whether you are a user or developer. For example:
72-
73-
- [Submit bugs and feature requests][new-issue-url].
74-
- Review documentation and make pull requests for anything from typos to new content.
75-
- Give feedback on the onboarding process to make it easier for others to join the project.
76-
77-
If you're interested in contributing to the source code of Theme Tool, then please see [Contributing Guidelines](./CONTRIBUTING.md).
78-
79-
## People
44+
The easiest way to communicate is via [GitHub issues](https://github.com/shabados/viewer/issues). Please search for similar issues regarding your concerns before opening a new issue.
8045

81-
The original author and current lead maintainer is Saihajpreet Singh ([@saihaj](https://github.com/saihaj)).
46+
Get organization updates for Shabad OS by following us on [Instagram](https://www.instagram.com/shabad_os/) and [Twitter](https://twitter.com/shabad_os/). We also invite you to join us on our public chat server hosted on [Slack](https://chat.shabados.com/).
8247

83-
"Thank you!" to [all the volunteers][contributor-url] who've contributed to Theme Tool.
48+
Our intention is to signal a safe open-source community. Please help us foster an atmosphere of kindness, cooperation, and understanding. By participating, you agree to abide by the [Contributor Covenant](https://www.contributor-covenant.org/version/2/0/code_of_conduct/).
8449

85-
## Feedback
50+
If you have a concern that doesn't warrant opening a GitHub issue, please reach out to us:
8651

87-
- Ask questions and get help in our community chat via [Slack][chat-url]
88-
- [Upvote popular feature requests][upvote-tracker-url] using the thumbs-up/+1 reaction on the first post of a feature request
89-
- Follow [@shabad_os on Instagram](instagram-url) and [@shabad_os on Twitter](twitter-url) and let us know what you think!
52+
Saihajpreet Singh, Author, Maintainer: [@saihaj](https://github.com/saihaj)
9053

91-
## Related Projects
92-
93-
Projects in the Shabad OS ecosystem of free and open source software include:
94-
95-
- [Database](https://github.com/shabados/database)
96-
- [Viewer](https://github.com/shabados/viewer)
97-
- [Presenter](https://github.com/shabados/presenter)
98-
- [Mobile](https://github.com/shabados/mobile)
99-
- [Gurmukhi Utils](https://github.com/shabados/gurmukhi-utils)
100-
101-
## Code of Conduct
102-
103-
Please note that this project is released under the Contributor Covenant. By participating in this project you agree to abide by its terms. Our intention is to signal a safe open-source community by welcoming all people to contribute, and pledging in return to value them as whole human beings and to foster an atmosphere of kindness, cooperation, and understanding.
104-
105-
> We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.
106-
>
107-
> We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
108-
>
109-
> [The Contributor Covenant][contributor-covenant-url]
110-
111-
## License
112-
113-
This project is under v3 of the [GPL](LICENSE.md). It is similar to the Golden Rule: do unto others as you would have them do unto you. In exchange for benefitting from the work completed in this repo, others must share their derivative work under v3 of the [GPL](LICENSE.md).
114-
115-
> This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
116-
>
117-
> This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
118-
>
119-
> You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
54+
## Contributing
12055

121-
[release-image]: https://img.shields.io/github/workflow/status/shabados/theme-tool/Build%20and%20Deploy/master.svg?label=release
122-
[release-url]: https://github.com/shabados/theme-tool/actions?query=workflow%3A%22Build+and+Deploy%22+branch%3Amaster
123-
[next-image]: https://img.shields.io/github/workflow/status/shabados/theme-tool/Build%20and%20Deploy/dev.svg?label=next%20release
124-
[next-url]: https://github.com/shabados/theme-tool/actions?query=workflow%3A%22Build+and+Deploy%22+branch%3Adev
125-
[website-url]: https://shabados.com
126-
[instagram-image]: https://img.shields.io/badge/Instagram-%40shabad__os-C13584.svg?logo=instagram&logoColor=white
127-
[instagram-url]: https://www.instagram.com/shabad_os/
128-
[twitter-image]: https://img.shields.io/badge/Twitter-%40shabad__os-1DA1F2.svg?logo=twitter&logoColor=white
129-
[twitter-url]: https://www.twitter.com/shabad_os/
130-
[chat-image]: https://img.shields.io/badge/Chat-Public%20Slack%20Channels-1264a3.svg?logo=slack
131-
[chat-url]: https://chat.shabados.com
132-
[new-issue-url]: https://github.com/shabados/theme-tool/issues/new/choose
133-
[contributor-url]: https://github.com/shabados/theme-tool/graphs/contributors
134-
[upvote-tracker-url]: https://github.com/shabados/theme-tool/issues?q=is%3Aopen+is%3Aissue+label%3A%22Type%3A+Feature%2FEnhancement%22+sort%3Areactions-%2B1-desc
135-
[contributor-covenant-url]: https://www.contributor-covenant.org/version/2/0/code_of_conduct/
56+
Please see [CONTRIBUTING.md](/CONTRIBUTING.md).

0 commit comments

Comments
 (0)