How to Contribute to EmuDeck

How to Contribute to EmuDeck

How to Contribute to the EmuDeck Wiki

EmuDeck Wiki GitHub Repository: https://github.com/EmuDeck/emudeck.github.io

Option 1: A quick shout-out

Send a quick message on EmuDeck's Discord stating what needs to be edited or added.

Option 2: Opening an Issue

You will need to create a GitHub account to open an issue. To sign up for GitHub, see https://github.com/signup.

Once you have created an account, you can visit this page: https://github.com/EmuDeck/emudeck.github.io/issues and submit an issue.

Option 3: Editing the Markdown files

You will need to create a GitHub account to open a Pull Request. To sign up for GitHub, see https://github.com/signup.

Markdown is a fairly straightforward markup language. If you are not familiar, you can take a quick look at the documents in the docs folder.

Depending on your comfort level with GitHub, you can either use GitHub's web editor to edit any markdown files or you may also clone the repository and edit the markdown files that way.

To edit markdown files in GitHub's web editor, open a document in the docs folder, and click the small pencil icon in the top right. Once you are finished, click Commit changes... GitHub will prompt you to open a Pull Request, which will then be merged once it is reviewed.

Once the PR is merged and reviewed, your changes will automatically be deployed to the website.

If you do choose to clone the repository, you only need to clone the main branch.

Depending on your permission level, when you are finished making edits, either push your changes to main or create a Pull Request. Any changes you make to the markdown files will automatically be pushed to the gh-pages branch and deployed to the website once you have either pushed your changes to main or your Pull Request is approved and merged.

How to Contribute Using GitHub's Web Editor

Select a document to edit in the docs folder here: https://github.com/EmuDeck/emudeck.github.io/tree/main/docs

This section will use Dolphin on SteamOS as an example.

On the page you would like to edit, click the pencil icon in the top right
Make any changes you would like
Once you are finished making your changes, click the Commit changes... button in the top right
You will be prompted to create a Pull Request. Add a little bit of detail about what you added and why
- You will not see the option to Commit directly to the main branch so do not worry about inadvertently making any changes
Submit your Pull Request
Once your Pull Request is reviewed, it will be merged and any of your changes will automatically be deployed to the website

Examples of Wiki Contributions

New Issues With Emulators

If you notice a new update with an emulator or tool significantly impacts its functionality, you may edit the wiki to bring notice and suggest possible temporary solutions.

To do so, add a section to the Known Issues page with a date of when the issue occurred. To edit the page, visit https://github.com/EmuDeck/emudeck.github.io/blob/main/docs/known-issues/steamos/index.md and see How to Contribute Using GitHub's Web Editor to learn how.

After editing the page, you may also use GitHub's web editor to edit the main.html file in the overrides folder, https://github.com/EmuDeck/emudeck.github.io/blob/main/overrides/main.html to include an announcement at the top of the website alerting users to the issue on the Known Issues page.

As an example for how main.html might be formatted, see below:

{% extends "base.html" %}

{% block announce %}
ANNOUNCEMENT: Audio is not working in the latest version of DuckStation, visit <a href="https://emudeck.github.io/known-issues/steamos/#duckstation-audio-not-working-september-16th-2023">https://emudeck.github.io/known-issues/steamos/#duckstation-audio-not-working-september-16th-2023</a> for a solution.
{% endblock %}

Only the text between {% block announce %} and {% endblock %} needs to be updated when a new major issue occurs. To link to a page, <a href="linktopage">repeatsamelinkhere</a>. Example: <a href="https://www.google.com/">https://www.google.com/</a>.

Once the issue is resolved, you may edit the same section on the Known Issues including when it was resolved. You do not need to remove the section.