aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2024-01-05 18:40:45 -0800
committerJohn MacFarlane <[email protected]>2024-01-05 18:40:45 -0800
commit5d33b5690a10e10a5a1775eaa03b508446452ca1 (patch)
tree42c1cba772bd5ddb671171f2c3937adb74331d84
parent714ed52213fd6649350ccebe741caefc11cc5a04 (diff)
Replace references to pandoc-discuss with GitHub discussions.
-rw-r--r--.github/ISSUE_TEMPLATE/bug_report.md7
-rw-r--r--.github/ISSUE_TEMPLATE/config.yml5
-rw-r--r--CONTRIBUTING.md29
-rw-r--r--README.md2
4 files changed, 24 insertions, 19 deletions
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 8eb77bc46..f53a163aa 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -10,10 +10,13 @@ assignees: ''
Thank you for reporting an issue! Before you continue, please make sure that you have
- searched the [issue tracker](https://github.com/jgm/pandoc/issues) for similar issues (including closed issues).
-- searched the [pandoc-discuss mailing list](https://groups.google.com/forum/#!forum/pandoc-discuss) for solutions.
+- searched the [discussion forum](https://github.com/jgm/pandoc/discussions) for
+ solutions.
- reproduced your issue on the [latest release of pandoc](https://github.com/jgm/pandoc/releases), or online at [try pandoc](https://pandoc.org/try).
-Note that this bug tracker is for reporting bugs, not asking questions. For questions, use the [pandoc-discuss mailing list](https://groups.google.com/forum/#!forum/pandoc-discuss).
+Note that this bug tracker is for reporting bugs, not asking
+questions. For questions, use the [discussion
+forum](https://github.com/jgm/pandoc/discussions).
-->
**Explain the problem.**
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
index e4d479ce6..79b0a0890 100644
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -1,8 +1,9 @@
blank_issues_enabled: false
contact_links:
- name: Ask a question
- url: https://groups.google.com/forum/#!forum/pandoc-discuss
- about: "Discussion forum for pandoc (may be used as an email list)"
+ url: https://github.com/jgm/pandoc/discussions
+ # https://groups.google.com/forum/#!forum/pandoc-discuss
+ about: "Discussion forum for pandoc"
- name: Contributing Guidelines
url: https://pandoc.org/CONTRIBUTING.html
about: "Guidelines for submitting bug reports and code improvements"
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4e7acb50e..8cda552f1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -12,16 +12,15 @@ How can I help?
There are many ways in which you can support pandoc. Here are a few
ideas:
- * Participate in online discussions. The [pandoc-discuss] mailing
- list is a good place for this. This gives valuable input and
- makes it easier to improve the program.
+ * Participate in online discussions. The [discussion
+ forum] is a good place for this.
* Help with questions. Every request that is answered by the wider
community frees time for programming contributors. This will
speed up development of new features and issue fixes. Don't
underestimate your knowledge, please share it!
- Good places to help are the [pandoc-discuss] mailing list, Q/A
+ Good places to help are the [discussion forum], Q/A
sites like StackOverflow, community forums (e.g.
[RStudio][RStudio Community], [Zettlr][Zettlr Forum]), and, for
technical questions, the GitHub [issue tracker].
@@ -62,7 +61,7 @@ the boundaries of what is possible with pandoc.
Have a question?
----------------
-Ask on [pandoc-discuss].
+Ask on the [discussion forum].
Found a bug?
@@ -119,7 +118,7 @@ to `odt`. (You can, however, customize margin size using `--reference-doc`.)
So before submitting a bug report, consider whether it might be
"out of scope." If it concerns a feature of documents that isn't
representable in pandoc's Markdown, then it very likely is.
-(If in doubt, you can always ask on [pandoc-discuss].)
+(If in doubt, you can always ask on the [discussion-forum].)
Fixing bugs from the issue tracker
----------------------------------
@@ -133,8 +132,8 @@ summary of issues can be found on [GitHub labels].
issue is generic and can be resolved without deep knowledge of the code
base.
* [enhancement] — A feature which would be desirable. We recommend
- you discuss any proposed enhancement on pandoc-discuss before
- writing code.
+ you discuss any proposed enhancement on the [discussion forum]
+ before writing code.
* [bug] — A problem which needs to be fixed.
* [complexity:low] — The fix should only be a couple of lines.
* [complexity:high] — The fix might require structural changes or in depth
@@ -156,7 +155,8 @@ or bug reports related to Markdown are labelled with [format:markdown].
Have an idea for a new feature?
-------------------------------
-First, search [pandoc-discuss] and the issue tracker (both [open issues] *and*
+First, search the [discussion forum]
+and the issue tracker (both [open issues] *and*
[closed issues]) to make sure that the idea has not been discussed before.
Explain the rationale for the feature you're requesting. Why would this
@@ -168,15 +168,16 @@ maintained. This is especially relevant for large or complex
contributions. It is helpful to be sympathetic to that fact, and to
communicate future plans and availability clearly.
-Any potential new feature is best discussed on [pandoc-discuss]
-before opening an issue.
+Any potential new feature is best discussed on the [discussion
+forum] before opening an issue.
Patches and pull requests
-------------------------
Patches and pull requests are welcome. Before you put time into a nontrivial
-patch, it is a good idea to discuss it on [pandoc-discuss], especially if it is
-for a new feature (rather than fixing a bug).
+patch, it is a good idea to discuss it on the
+[discussion forum], especially if it is for a new feature (rather
+than fixing a bug).
Please follow these guidelines:
@@ -457,3 +458,5 @@ you may want to consider submitting a pull request to the
[status:more-discussion-needed]: https://github.com/jgm/pandoc/labels/status:more-discussion-needed
[status:more-info-needed]: https://github.com/jgm/pandoc/labels/status:more-info-needed
[stack]: https://github.com/commercialhaskell/stack
+[discussion forum]: https://github.com/jgm/pandoc/discussions
+
diff --git a/README.md b/README.md
index 7c529213a..baaae61a2 100644
--- a/README.md
+++ b/README.md
@@ -15,8 +15,6 @@ package](https://stackage.org/package/pandoc/badge/lts)](https://www.stackage.or
[![CI
tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://github.com/jgm/pandoc/actions)
[![license](https://img.shields.io/badge/license-GPLv2+-lightgray.svg)](https://www.gnu.org/licenses/gpl.html)
-[![pandoc-discuss on google
-groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
## The universal markup converter