Skip to content

Commit 8b6773f

Browse files
committed
Testing CI fix again
1 parent a6ed8d1 commit 8b6773f

File tree

2 files changed

+65
-2
lines changed

2 files changed

+65
-2
lines changed

.github/workflows/mdbook.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ jobs:
4848
- name: Build with mdBook
4949
run: mdbook build
5050
- name: Upload artifact
51-
uses: actions/upload-pages-artifact@v2
51+
uses: actions/upload-pages-artifact@v3
5252
with:
5353
path: ./book
5454

@@ -62,4 +62,4 @@ jobs:
6262
steps:
6363
- name: Deploy to GitHub Pages
6464
id: deployment
65-
uses: actions/deploy-pages@v2
65+
uses: actions/deploy-pages@v2

documentation/contributing.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
<div class="header-banner purple">
2+
<div class="header-label purple">Contributing to Dialogic</div>
3+
</div>
4+
5+
We develop the Dialogic plugin in the open at [GitHub](https://github.com/dialogic-godot).
6+
The main [dialogic](https://github.com/dialogic-godot/dialogic) repository that contains all the code, images, and logic for the plugin, and this documentation is stored in the [documentation](https://github.com/dialogic-godot/documentation) repository. You will find other repositories such as the [Godot 3 version of Dialogic](https://github.com/dialogic-godot/dialogic-1), a [test project](https://github.com/dialogic-godot/test-project), a [visual novel template](https://github.com/dialogic-godot/visual-novel-template), extensions and more.
7+
8+
## How to contribute
9+
10+
There are different ways to contribute to Dialogic. You could be a developer, a designer, a writer, or a user who wants to help improve the project. Here are some ways you can contribute:
11+
- [Reporting bugs](#reporting-bugs)
12+
- [Creating pull requests](#creating-pull-requests)
13+
- [Answering questions](#answering-questions)
14+
- [Donating](#donate)
15+
16+
17+
### Reporting bugs
18+
While working on your project, you might encounter a bug or come up with an idea for a new feature that could benefit the Dialogic community. If you believe this improvement or bug fix would be valuable to the majority of users, it is a good candidate for an issue. Dialogic and Godot are designed to be flexible and extensible, so it is better to remain agnostic to specific game requirements. Before creating a new issue, consider the following steps to help us improve Dialogic:
19+
20+
- **Search for Similar Issues:** Use the [search function](https://github.com/dialogic-godot/dialogic/issues) on GitHub to enter keywords related to your identified issue. This helps you see if someone has already reported it.
21+
- **Review Existing Issues:** Go through the [list of existing issues](https://github.com/dialogic-godot/dialogic/issues) to check if your issue is already documented. If it is, consider contributing to the discussion or offering to help resolve it instead of creating a new one.
22+
23+
If your issue doesn’t exist, create it by pressing on the "New issue" button or by visiting [this page](https://github.com/dialogic-godot/dialogic/issues/new/choose). Remember to describe the issue in detail, including steps to reproduce it if it's a bug, the version of Godot and Dialogic you are using, or explaining why the new feature is beneficial. If it is a bug, it is extremely helpful to include a minimal code example that reproduces the issue, such as a small Godot+Dialogic project demonstrating the problem. This helps maintainers quickly identify the cause of the issue and fix it.
24+
25+
26+
### Creating Pull Requests
27+
28+
If you have identified an existing issue and want to contribute a fix or enhancement, follow these steps to create a pull request:
29+
30+
1. **Fork the Repository:** Click the "Fork" button on the top right of the repository page. This will create a copy of the repository in your GitHub account.
31+
2. **Clone the Repository:** Click the "Code" button and copy the URL. Then, in your terminal, run:
32+
```bash
33+
git clone <URL>
34+
```
35+
3. **Create a New Branch:** Navigate to the repository directory on your local machine and create a new branch for your changes:
36+
```bash
37+
git checkout -b <branch-name>
38+
```
39+
4. **Make Your Changes:** Edit the files in the repository to implement your fix or enhancement.
40+
5. **Commit Your Changes:** Stage and commit your changes with a descriptive message:
41+
```bash
42+
git add .
43+
git commit -m "Your message here"
44+
```
45+
6. **Push Your Changes:** Push your changes to your forked repository:
46+
```bash
47+
git push origin <branch-name>
48+
```
49+
7. **Create a Pull Request:** Go to the repository page on GitHub and click the "New pull request" button. Select the correct branches and provide a detailed description of your changes, referencing the issue you are addressing.
50+
51+
If you find using the terminal challenging, you can also use the [GitHub Desktop](https://desktop.github.com/) app or another graphical git client to manage your changes. These tools offer an easier interface for working with git, allowing you to focus more on your contributions rather than command-line operations.
52+
53+
After submitting your pull request, monitor it for any comments or feedback from the project maintainers. If revisions are required, make the necessary changes based on their feedback and push the updates to your branch; your pull request will be automatically updated. Engage politely with reviewers, thank them for their feedback, and ask for clarification if needed. Remember, we are all volunteers working together to improve the project for everyone, so it's important to maintain a positive and collaborative atmosphere.
54+
55+
56+
### Answering questions
57+
58+
Answering questions is another valuable way to contribute to the Dialogic community. You can help by participating in our [GitHub Discussions page](https://github.com/dialogic-godot/dialogic/discussions) and our [Discord server](https://discord.com/invite/DjcDgDaTMe), where users frequently ask questions about using the plugin, troubleshooting issues, or seeking advice on best practices.
59+
60+
61+
### Donating
62+
63+
If you like Dialogic and want to support its development, you can donate to the project via [Patreon](https://www.patreon.com/jowanspooner), or [Ko-fi](https://ko-fi.com/jowan_spooner). Your support is greatly appreciated and helps to keep the project going!

0 commit comments

Comments
 (0)