diff --git a/.github/ISSUE_TEMPLATE/1-bug.yml b/.github/ISSUE_TEMPLATE/1-bug.yml new file mode 100644 index 0000000..d76444d --- /dev/null +++ b/.github/ISSUE_TEMPLATE/1-bug.yml @@ -0,0 +1,87 @@ +name: Bug report +description: Something in the game is broken, looks wrong or crashes. +title: "[bug] " +labels: [bug, triage] +body: + - type: markdown + attributes: + value: | + Thanks for reporting! The more of this you fill in, the faster it gets fixed. + **One bug per issue, please.** + - type: textarea + id: what + attributes: + label: What happened? + description: Describe what went wrong. Screenshots or a screen recording help a lot. Drag them into this box. + validations: + required: true + - type: textarea + id: steps + attributes: + label: Steps to reproduce + description: What did you do right before it happened? + placeholder: | + 1. Open the Infra tab in Frankfurt + 2. Tap "Upgrade to 400G" + 3. … + validations: + required: true + - type: textarea + id: expected + attributes: + label: What did you expect instead? + validations: + required: true + - type: input + id: version + attributes: + label: Game version + description: Shown at the bottom of the title screen, and in the menu under "What's new". + placeholder: "1.25.1" + validations: + required: true + - type: dropdown + id: device + attributes: + label: Device + options: + - Android phone + - iPhone + - Android tablet + - iPad + - Desktop or laptop + - Other + validations: + required: true + - type: input + id: browser + attributes: + label: Browser and version + placeholder: "Firefox 159 on Android 16, Safari on iOS 26.1, Chrome 141 on Windows…" + validations: + required: true + - type: dropdown + id: installed + attributes: + label: Installed as an app? + description: Did you add Series of Tubes to your home screen, or do you play in a browser tab? + options: + - In a browser tab + - Installed on the home screen + - Not sure + validations: + required: true + - type: textarea + id: save + attributes: + label: Saved game (optional, very helpful) + description: Menu → "Export save", then attach the file here. It lets us load your exact network. + - type: checkboxes + id: checks + attributes: + label: Before you submit + options: + - label: I searched the existing issues and this one is not already reported. + required: true + - label: This issue is about one bug only. + required: true diff --git a/.github/ISSUE_TEMPLATE/2-feature.yml b/.github/ISSUE_TEMPLATE/2-feature.yml new file mode 100644 index 0000000..cf46ef2 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/2-feature.yml @@ -0,0 +1,54 @@ +name: Feature request +description: An idea for something new in the game. +title: "[feature] " +labels: [enhancement, triage] +body: + - type: markdown + attributes: + value: | + Ideas are welcome! The best ones describe what happens in real networks and how it could become a fun mechanic. + **One idea per issue, please.** + - type: dropdown + id: area + attributes: + label: Part of the game + options: + - Map and interface + - Phones and tablets + - Network building (POPs, links, fiber, routers) + - Peering, transit and exchanges + - Customers + - Money, banks and prices + - Incidents and events + - Scenarios, goals and badges + - Something else + validations: + required: true + - type: textarea + id: problem + attributes: + label: What problem does it solve, or what is missing? + description: For example "When I reach Tier 1 I can't find where my transit ports are." + validations: + required: true + - type: textarea + id: idea + attributes: + label: Your idea + description: How would it work in the game? + validations: + required: true + - type: textarea + id: real + attributes: + label: How does this work in real life? (optional) + description: Links, war stories and real-world numbers make an idea much easier to model well. + - type: checkboxes + id: checks + attributes: + label: Before you submit + options: + - label: I searched the existing issues and nobody suggested this yet. + required: true + - label: This issue is about one idea only. + required: true diff --git a/.github/ISSUE_TEMPLATE/3-balance.yml b/.github/ISSUE_TEMPLATE/3-balance.yml new file mode 100644 index 0000000..7a91c39 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/3-balance.yml @@ -0,0 +1,40 @@ +name: Balance or realism +description: Something works, but prices, odds or behaviour feel off compared with the real internet. +title: "[balance] " +labels: [balance, triage] +body: + - type: textarea + id: what + attributes: + label: What feels off? + description: For example "Overland waves between continents are cheaper than subsea, but in real life it's the other way round." + validations: + required: true + - type: textarea + id: real + attributes: + label: How it is in real life + description: Real prices, ratios, links or experience from your own network. + validations: + required: true + - type: textarea + id: suggestion + attributes: + label: What would you change? (optional) + - type: input + id: version + attributes: + label: Game version + description: Shown at the bottom of the title screen, and in the menu under "What's new". + placeholder: "1.25.1" + validations: + required: true + - type: checkboxes + id: checks + attributes: + label: Before you submit + options: + - label: I searched the existing issues and this is not already reported. + required: true + - label: This issue is about one topic only. + required: true diff --git a/.github/ISSUE_TEMPLATE/4-translation.yml b/.github/ISSUE_TEMPLATE/4-translation.yml new file mode 100644 index 0000000..31d261e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/4-translation.yml @@ -0,0 +1,42 @@ +name: Translation +description: A wrong, awkward or missing translation, or a new language. +title: "[translation] " +labels: [translation, triage] +body: + - type: dropdown + id: lang + attributes: + label: Language + options: + - Italiano + - A new language (say which below) + validations: + required: true + - type: textarea + id: where + attributes: + label: Where in the game? + description: Which screen, panel or message? A screenshot helps. + validations: + required: true + - type: textarea + id: current + attributes: + label: Current text + validations: + required: true + - type: textarea + id: suggested + attributes: + label: Suggested text + validations: + required: true + - type: checkboxes + id: checks + attributes: + label: Before you submit + options: + - label: I am a fluent speaker of this language. + required: true + - label: I searched the existing issues first. + required: true diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000..10aa563 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,5 @@ +blank_issues_enabled: false +contact_links: + - name: How the internet really works + url: https://tkjaer.github.io/how-the-internet-works/ + about: Curious how the real thing works? This interactive map explains it far better than any game. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 257edc3..8389cf6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -5,9 +5,10 @@ translations and code are all welcome. ## Reporting bugs and ideas -Open an issue on GitHub. For bugs, include what you did, what you expected and what -happened. If it involves a game in progress, attach an export of your save (menu → -Export), which lets us load your exact network. +Open an issue on GitHub and pick the form that fits: bug report, feature request, +balance or realism, or translation. Blank issues are turned off so every report has +what we need to triage it. For bugs, an export of your save (menu → Export save) +lets us load your exact network. One topic per issue, please. Ideas are best when they say what happens in real networks and how that could become a fun mechanic.