Merge pull request #466 from JonathanGregory/discussions

Add links to CF Discussions and update description of use of issues

Author: cofinoa

discussion.md

@@ -5,36 +5,44 @@ group: "navigation"
 ---
 
 # Discussion
+
+CF is carrying out a trial (beginning in March 2024) of using the CF [GitHub organization Discussions][github_discussions] for announcements relevant to CF, community discussion of comments and ideas for changing CF, and for questions and answers about how to use CF.
+
+Announcements, discussions and Q&A that were initiated _before_ the trial of CF GitHub Discussions began are continuing as [GitHub issues][github_issues] in the [`discuss` repository][github_discuss]. (These might later be moved to GitHub Discussions if the trial is successful.)
 
-Discussion about CF Metadata takes place on GitHub in three forums, using [GitHub issues][github_issues].
+Proposals for changing CF are discussed as [GitHub issues][github_issues] in three repositories:
 
-*   [General discussion and standard names][github_discuss]
+*   [Vocabulary][github_discuss]
 
-    For proposing standard names, asking questions or having discussions about the interpretation and use of the CF conventions, and initial suggestions for proposals to change or extend the CF conventions.
+    For proposing additions or amendments to standard names, their definitions, or other CF controlled vocabulary (area types and standardized regions).
 
-    The status of proposals about standard names that have been initiated on the general discussion forum is shown by the [CEDA vocabulary editor][vocab_editor].
+    As well as in GitHub issues, the status of proposals about standard names is shown by the [CEDA vocabulary editor][vocab_editor]. To see a list of resolved proposals (accepted or rejected) for standard names from March 2011 onwards, click "Inactive" in the [CEDA vocabulary editor][vocab_editor]
 
 *   [Conventions][github_conventions]
 
-    For proposing enhancements and reporting defects in the CF conventions, that may or may not have started as conversations on the general discussion forum.
+    For proposing enhancements and reporting defects in the CF conventions.
+
+    Closed issues: [change agreed][github_conventions_change], [agreement not to change][github_conventions_nochange], [dormant][github_conventions_dormant] i.e. the discussion on a proposed change did not reach a conclusion. Dormant issues may be reopened if there is a new impetus or ideas that might help bring about an agreement.
 
 *   [Website and governance][github_website]
 
-    For discussing, proposing changes and reporting defects in the [CF website][website], and for discussion of CF governance.
+    For discussing, proposing changes and reporting defects in the [CF website][website] or CF governance.
 
 No registration with CF is required to contribute; all that is needed is a freely available [GitHub account][github].
 
-Before the CF community migrated to GitHub, general and standard-name discussion took place on the [cf-metadata mailing list][archives], and enhancements to the conventions were proposed on the [CF Metadata Trac](Data/trac.html) site.
-
 ### Archive links
 
+Before the CF community migrated to GitHub, general and standard-name discussion took place on the [cf-metadata mailing list][archives], and enhancements to the conventions were proposed on the [CF Metadata Trac](Data/trac.html) site.
+
 * cf-metadata mailing list archive [copy on GitHub][archives] or [original at NCAR][NCAR_archives] (until December 2019)
-* To see a list of resolved proposals (accepted or rejected) for standard names from March 2011 onwards, click "Inactive" in the [CEDA vocabulary editor][vocab_editor]
 * [CF Metadata Trac](Data/trac.html) (until July 2018)
 * [About CF Metadata Trac][about]
 
 [github_discuss]: https://github.com/cf-convention/discuss/issues
 [github_conventions]: https://github.com/cf-convention/cf-conventions/issues
+[github_conventions_change]: https://github.com/cf-convention/cf-conventions/issues?q=is:issue+label:"change agreed"
+[github_conventions_nochange]: https://github.com/cf-convention/cf-conventions/issues?q=is:issue+label:"agreement not to change"
+[github_conventions_dormant]: https://github.com/cf-convention/cf-conventions/issues?q=is:issue+label:dormant
 [github_website]: https://github.com/cf-convention/cf-convention.github.io/issues
 [github]: https://github.com
 [website]: https://cfconventions.org
@@ -46,3 +54,4 @@ Before the CF community migrated to GitHub, general and standard-name discussion
 [current]: https://cfeditor.ceda.ac.uk/proposals/1
 [vocab_editor]: https://cfeditor.ceda.ac.uk/proposals/1
 [github_issues]: https://guides.github.com/features/issues
+[github_discussions]: https://github.com/orgs/cf-convention/discussions

index.md

@@ -36,14 +36,14 @@ The use of CF is recommended where applicable by Unidata.
 
 See also the links in the navigation bar at the top of this page.
 
-* Current issues: [general discussion][github_discuss] (including standard names), [conventions][github_conventions], this [website][github_website] (including governance)
+* [CF GitHub Discussions][github_discussions]: announcements, forum for community discussion, questions and answers
+* Current proposals for changing CF (CF GitHub issues): [vocabulary][github_discuss] (including standard names), [conventions][github_conventions], this [website][github_website] (including governance)
 * [CF GitHub organisation][cf_github]
 * [CF FAQ][faq]
 * [List of software for working with CF](software.md)
 * [Paper][cfdmpaper] describing the CF data model and reference software
 * Overview of CF basics as a [presentation][viewgraphs] and [paper][article]
 
-
 [api]: https://www.unidata.ucar.edu/software/netcdf/index.html
 [coards]: https://ferret.pmel.noaa.gov/noaa_coop/coop_cdf_profile.html
 [viewgraphs]: Data/cf-documents/overview/viewgraphs.pdf
@@ -63,3 +63,4 @@ See also the links in the navigation bar at the top of this page.
 [github_conventions]: https://github.com/cf-convention/cf-conventions/issues
 [github_website]: https://github.com/cf-convention/cf-convention.github.io/issues
 [cf_github]: https://github.com/cf-convention
+[github_discussions]: https://github.com/orgs/cf-convention/discussions