Skip to content

Commit

Permalink
Merge pull request #117 from VipinDevelops/main-modal-doc
Browse files Browse the repository at this point in the history
docs(Main-modal): 📝 add doc's for main modal
  • Loading branch information
samad-yar-khan authored Mar 10, 2024
2 parents fb5eaa2 + 65f27ac commit 24bea46
Showing 1 changed file with 37 additions and 21 deletions.
58 changes: 37 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,29 +21,46 @@ The GitHub Rocket.Chat App provides a seamless integration between GitHub and Ro
<li>Search Issues and Pull Request using extensive filters and share them on Rocket.Chat</li>
</ul>

<h2 align='center'>💡 Usage 💡</h2>
<h2 align="center">💡 Usage 💡</h2>

<p style="font-size: 1em;"><em>Open Main Modal for Quick Access to Different Features</em></p>

<p>To open the main modal and access various features, use the command: <code>/github</code>.</p>


### Main Modal Features:

- Quick access to GitHub search
- Create new issues
- Manage repository subscriptions
- Assign issues to users

<p style="font-size: 1rem" >The app can be accessed with any of the following slash commands: <code>/gh</code> or <code>/github</code>.</p>

### Command List

<ul>
<li> See Helper Message / Command List -> /github help </li>
<li> The app can be accessed with any of the slash commands /gh or /github </li>
<li> Login to GitHub -> /github login </li>
<li> Logout from GitHub -> /github logout </li>
<li> View your GitHub Profile and Issues -> /github me </li>
<li> View/Add/Delete/Update Repository Subscriptions -> /github subscribe </li>
<li> Subscribe to all repository events -> /github Username/RepositoryName subscribe </li>
<li> Unsubscribe to all repository events -> /github Username/RepositoryName unsubscribe </li>
<li> Add New Issues to GitHub Repository -> /github issue </li>
<li> Search Issues and Pull Request -> /github search </li>
<li> Assign and Share GitHub issues -> /github issues </li>
<li> Review a Pull Request -> /github Username/RepositoryName pulls pullNumber </li>
<li> See Interactive Button interface to fetch repository data -> /github Username/RepositoryName </li>
<li> Get details of a Repository -> /github Username/RepositoryName repo </li>
<li> Get Issues of a Repository -> /github Username/RepositoryName issues </li>
<li> Get Contributors of a Repository -> /github Username/RepositoryName contributors </li>
<li> Get Recent Pull Request of a Repository -> /github Username/RepositoryName pulls </li>
<li><strong>See Helper Message / Command List →</strong> <code>/github help</code></li>
<li><strong>Login to GitHub →</strong> <code>/github login</code></li>
<li><strong>Logout from GitHub →</strong> <code>/github logout</code></li>
<li><strong>View your GitHub Profile and Issues →</strong> <code>/github me</code></li>
<li><strong>View/Add/Delete/Update Repository Subscriptions →</strong> <code>/github subscribe</code></li>
<li><strong>Subscribe to all repository events →</strong> <code>/github Username/RepositoryName subscribe</code></li>
<li><strong>Unsubscribe to all repository events →</strong> <code>/github Username/RepositoryName unsubscribe</code></li>
<li><strong>Add New Issues to GitHub Repository →</strong> <code>/github issue</code></li>
<li><strong>Search Issues and Pull Request →</strong> <code>/github search</code></li>
<li><strong>Assign and Share GitHub issues →</strong> <code>/github issues</code></li>
<li><strong>Review a Pull Request →</strong> <code>/github Username/RepositoryName pulls pullNumber</code></li>
<li><strong>See Interactive Button interface to fetch repository data →</strong> <code>/github Username/RepositoryName</code></li>
<li><strong>Get details of a Repository →</strong> <code>/github Username/RepositoryName repo</code></li>
<li><strong>Get Issues of a Repository →</strong> <code>/github Username/RepositoryName issues</code></li>
<li><strong>Get Contributors of a Repository →</strong> <code>/github Username/RepositoryName contributors</code></li>
<li><strong>Get Recent Pull Request of a Repository →</strong> <code>/github Username/RepositoryName pulls</code></li>
<li>Add a new repository for pull request review reminders -> /github reminder create</li>
<li>Get a list of repositories for which you've set up pull request review reminders -> /github reminder list</li>
</ul>


<h2 align='center'>🚀 Contributing 🚀</h2>

<div align='center' width='100%'>
Expand All @@ -56,7 +73,7 @@ The GitHub Rocket.Chat App provides a seamless integration between GitHub and Ro
<li>Set up the Application on your server using our <a href="#desktop_computer-quick-setup-desktop_computer">Quick Setup</a> and <a href="#desktop_computer-application-setup-desktop_computer">Application Setup</a>.</li>
<li>Explore the app and look for existing issues to solve. We look forward to new PRs :100:.</li>
<li>If you find a bug or a missing feature, feel free to open a new Issue.</li>
<li>If you are new to Rocket.Chat App Development, follow the <a href="https://developer.rocket.chat/apps-engine/rocket.chat-app">developement documentation</a> and <a href="https://rocketchat.github.io/Rocket.Chat.Apps-engine/">RocketChat Apps Engine TypeScript Defenitions</a></li>
<li>If you are new to Rocket.Chat App Development, follow the <a href="https://developer.rocket.chat/apps-engine/rocket.chat-apps-engine">developement documentation</a> and <a href="https://rocketchat.github.io/Rocket.Chat.Apps-engine/">RocketChat Apps Engine TypeScript Defenitions</a></li>
<li>You can also follow other Rocket.Chat Apps for inspiration : <a href="https://github.com/Poll-Plus/rocket.chat.app-poll">Polls Plus App</a>, <a href="https://github.com/RocketChat/Apps.ClickUp">ClickUp Rocket.Chat App</a> , <a href="https://github.com/RocketChat/Apps.Figma">Figma Rocket.Chat App</a>
</ul>

Expand Down Expand Up @@ -150,5 +167,4 @@ Once the GitHub OAuth app is setup, open the GitHub Application Settings and ent

The users can login to GitHub by entering the slash command `/github login` and then clicking on the `Login` button.

Users are logged out after a week but the users can also logout at any time by entering `/github logout`.

Users are logged out after a week but the users can also logout at any time by entering `/github logout`.

0 comments on commit 24bea46

Please sign in to comment.