diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index bcc0d14..a2ecff5 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -18,21 +18,23 @@ body: id: description attributes: label: Describe the bug - description: Please provide a clear and concise description of the bug. See ["Making a Good Trouble Report"](https://docs.hivecommons.dev/unreleased-development/kubestellar/troubleshooting/#making-a-good-trouble-report). - placeholder: | - You might also look at the rest of the "Troubleshooting" page. + description: Please provide a clear and concise description of the bug. validations: required: true - - type: textarea - id: snapshot + - type: input + id: page-url attributes: - label: Output from KubeStellar-Snapshot.sh - description: | - Run kubestellar-snapshot.sh from the scripts directory and paste output here. - Alternatively you can run the script remotely - bash <(curl -s https://raw.githubusercontent.com/kubestellar/kubestellar/refs/heads/main/scripts/kubestellar-snapshot.sh) -V -Y -L - This will create kubestellar-snapshot.tar.gz which can be dragged and dropped into this text area. + label: Page URL + description: The docs.hivecommons.dev page where you saw the problem, if any. + placeholder: https://docs.hivecommons.dev/... + + - type: input + id: environment + attributes: + label: Browser and OS + description: For rendering, search or navigation problems. + placeholder: e.g. Firefox 131 on macOS 15 - type: textarea id: reproducing diff --git a/.github/ISSUE_TEMPLATE/doc_issue.yaml b/.github/ISSUE_TEMPLATE/doc_issue.yaml index b2e7c6a..0332d3b 100644 --- a/.github/ISSUE_TEMPLATE/doc_issue.yaml +++ b/.github/ISSUE_TEMPLATE/doc_issue.yaml @@ -12,10 +12,12 @@ body: Before opening a new issue, look for an overlapping issue that you could contribute to. - Remember that documentation sources for the website are - intended to [also render nicely when viewed directly on - GitHub](https://github.com/hivecommons/kubestellar/blob/main/docs/README.md#dual-use-documentation-sources), - _to the degree possible_. + Most project pages (Hive, hotshot, pluk, rationguard, promptargs, + dibs and Spektacular) are synced from each project's own + repository at build time — see [How content is + sourced](https://github.com/hivecommons/docs#how-content-is-sourced). + Fixes to that content land in the project repository; this + repository owns site code, navigation and layout. Here is how you can help us serve you better: diff --git a/.github/ISSUE_TEMPLATE/epic.yaml b/.github/ISSUE_TEMPLATE/epic.yaml index e592be2..3a8510c 100644 --- a/.github/ISSUE_TEMPLATE/epic.yaml +++ b/.github/ISSUE_TEMPLATE/epic.yaml @@ -40,10 +40,10 @@ body: attributes: label: Stories placeholder: | - - [ ] (Example) Add new API group - - [ ] (Example) Add Widget API type - - [ ] (Example) Add WidgetController - - [ ] (Example) **stretch-goal:** Add Widgets to `kubectl kcp` plugin - - Out-of-scope (prototype x): Send Widgets to space + - [ ] (Example) Add the new section to the sidebar + - [ ] (Example) Sync the section's pages from the project repo + - [ ] (Example) Index the new pages in search + - [ ] (Example) **stretch-goal:** Add a landing page for the section + - Out-of-scope: Redesign the site theme validations: required: false