From 0f09f9c0c6f2836895acf69724f6a942595433f0 Mon Sep 17 00:00:00 2001 From: woodiertexas Date: Thu, 12 Sep 2024 16:36:33 -0700 Subject: [PATCH 1/4] make the getting started page far less condescending --- wiki/introduction/getting-started/en.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/wiki/introduction/getting-started/en.md b/wiki/introduction/getting-started/en.md index e002830b..0cd1fd86 100644 --- a/wiki/introduction/getting-started/en.md +++ b/wiki/introduction/getting-started/en.md @@ -36,11 +36,9 @@ Minecraft modding can get complicated. We aim to provide a resource to help you fundamental modding concepts. However, there are some things that we can't do and expect you to learn on your own. -Asking questions properly, whether it is on our forum or on Discord, is an essential -skill to have. Never be afraid to ask questions, we're always willing to help, and we -don't judge. +Never be afraid to ask questions, we're always willing to help, and we don't judge. -When asking questions, try to include the necessary context in your first message, and [do not ask to ask](https://dontasktoask.com/). State your problem, what you have already tried to solve it, and how those attempts failed. Make sure to avoid the [XY problem](https://xyproblem.info/) by not only asking for help for one specific part of a solution to your problem, but also stating the actual problem you are trying to solve. When debugging, include your `latest.log` and when your game crashes, a crash log. Additionally, full access to your source code can be really helpful, ideally uploaded to a website such as GitHub. +When asking questions, try to include the necessary context in your first message. State your problem, what you have already tried to solve it, and how those attempts failed. Giving full context to your problem will help others solve it faster. When debugging, include your `latest.log` and when your game crashes, a crash log. Additionally, full access to your source code can be really helpful, ideally uploaded to a website such as GitHub. You can ask development related questions in our [Forum](https://forum.quiltmc.org/), as well as in the [mod-dev-help](https://discord.com/channels/817576132726620200/1047429688521396325) forum channel in our [Discord](https://discord.quiltmc.org/) @@ -50,7 +48,7 @@ examples of how to do things in open source repositories and sometimes "steal" c Open source repositories are there for you to learn from and use, don't be afraid of them! -There are many topics in modding where you quickly will find yourself at a point where there are no tutorials to help. In those cases you'll usually either have to understand the relevant Minecraft code, or look at other mods and see how they got similar things done. +There are many topics in modding where you may quickly find there are many topics in modding lacking relevant tutorials. In those cases you may have to read the relevant Minecraft code, or look at other mods and see how they implemented similar ideas, methods or solutions. If you want to look into the Minecraft source code, run the `genSourcesWithVineflower` Gradle task in the `fabric` category or open any Minecraft source file and click the download sources button in IntelliJ IDEA. From 24cc78a7d71d8ac02a4b283ee591b46f66b876e0 Mon Sep 17 00:00:00 2001 From: woodiertexas Date: Fri, 13 Sep 2024 16:28:42 -0700 Subject: [PATCH 2/4] update workflows --- .github/workflows/commit-preview.yaml | 2 +- .github/workflows/pr-preview.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/commit-preview.yaml b/.github/workflows/commit-preview.yaml index 6b160ce4..746e081c 100644 --- a/.github/workflows/commit-preview.yaml +++ b/.github/workflows/commit-preview.yaml @@ -11,7 +11,7 @@ jobs: name: Generate commit preview steps: - name: Checkout - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Enable Corepack shims run: corepack enable diff --git a/.github/workflows/pr-preview.yaml b/.github/workflows/pr-preview.yaml index 369e3154..68473eeb 100644 --- a/.github/workflows/pr-preview.yaml +++ b/.github/workflows/pr-preview.yaml @@ -10,7 +10,7 @@ jobs: name: Generate PR preview steps: - name: Checkout - uses: actions/checkout@v3 + uses: actions/checkout@v4 - name: Enable Corepack shims run: corepack enable @@ -22,7 +22,7 @@ jobs: run: pnpm build - name: Upload HTML artifact - uses: actions/upload-artifact@v2 + uses: actions/upload-artifact@v4 with: name: website-html path: build From 6ea08b9994c96647a7029fb2ea3854de557b035a Mon Sep 17 00:00:00 2001 From: woodiertexas Date: Fri, 27 Sep 2024 18:22:44 -0700 Subject: [PATCH 3/4] Revert "update workflows" This reverts commit 24cc78a7d71d8ac02a4b283ee591b46f66b876e0. --- .github/workflows/commit-preview.yaml | 2 +- .github/workflows/pr-preview.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/commit-preview.yaml b/.github/workflows/commit-preview.yaml index 746e081c..6b160ce4 100644 --- a/.github/workflows/commit-preview.yaml +++ b/.github/workflows/commit-preview.yaml @@ -11,7 +11,7 @@ jobs: name: Generate commit preview steps: - name: Checkout - uses: actions/checkout@v4 + uses: actions/checkout@v3 - name: Enable Corepack shims run: corepack enable diff --git a/.github/workflows/pr-preview.yaml b/.github/workflows/pr-preview.yaml index 68473eeb..369e3154 100644 --- a/.github/workflows/pr-preview.yaml +++ b/.github/workflows/pr-preview.yaml @@ -10,7 +10,7 @@ jobs: name: Generate PR preview steps: - name: Checkout - uses: actions/checkout@v4 + uses: actions/checkout@v3 - name: Enable Corepack shims run: corepack enable @@ -22,7 +22,7 @@ jobs: run: pnpm build - name: Upload HTML artifact - uses: actions/upload-artifact@v4 + uses: actions/upload-artifact@v2 with: name: website-html path: build From 9a738733befd93b45df43fbe3473700d6c9e4bdd Mon Sep 17 00:00:00 2001 From: woodiertexas Date: Mon, 14 Oct 2024 23:19:13 -0700 Subject: [PATCH 4/4] Update wiki/introduction/getting-started/en.md Co-authored-by: ix0rai --- wiki/introduction/getting-started/en.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/wiki/introduction/getting-started/en.md b/wiki/introduction/getting-started/en.md index 0cd1fd86..40b32235 100644 --- a/wiki/introduction/getting-started/en.md +++ b/wiki/introduction/getting-started/en.md @@ -48,7 +48,7 @@ examples of how to do things in open source repositories and sometimes "steal" c Open source repositories are there for you to learn from and use, don't be afraid of them! -There are many topics in modding where you may quickly find there are many topics in modding lacking relevant tutorials. In those cases you may have to read the relevant Minecraft code, or look at other mods and see how they implemented similar ideas, methods or solutions. +There are many topics in modding lacking relevant tutorials. In those cases you may have to read the relevant Minecraft code, or look at other mods and see how they implemented similar ideas, methods or solutions. Don't be afraid to ask for help with understanding how Minecraft's systems work! If you want to look into the Minecraft source code, run the `genSourcesWithVineflower` Gradle task in the `fabric` category or open any Minecraft source file and click the download sources button in IntelliJ IDEA.