diff --git a/discussion.md b/discussion.md index dd4b395b..0515a0ad 100755 --- a/discussion.md +++ b/discussion.md @@ -3,47 +3,52 @@ layout: default title: Discussion 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. +CF discussions and decisions are mostly made on [GitHub][github]. No registration with CF is required to contribute; all that is needed is a freely available GitHub account. -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.) - -Proposals for changing CF are discussed as [GitHub issues][github_issues] in three repositories: +### Questions, comments and announcements about CF -* [Vocabulary][github_vocabularies] +In CF [GitHub organization Discussions][github_discussions] you can [ask a question](https://github.com/orgs/cf-convention/discussions/new?category=q-a-about-using-cf) about how to use CF, [comment](https://github.com/orgs/cf-convention/discussions/new?category=comments-and-ideas-for-changing-cf) on any aspect of CF or make a suggestion how CF could be changed or improved, contribute to any of the ongoing discussions, and read the previous ones. Announcements about CF are made there as well. - For proposing additions or amendments to standard names, their definitions, or other CF controlled vocabulary (area types and standardized regions). +To keep up-to-date with announcements and discussions, go to the [`discuss` repository][github_discuss] and enable notifications from the  Watch drop-down menu. - 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] +Discussions by category: ❓ [Questions and answers about using CF][github_qa]  💬 [Comments and ideas for changing CF][github_comment]  📣 [Announcements relevant to CF][github_announce] - For proposing enhancements and reporting defects in the CF conventions. +### Proposals to change CF + +Proposals to change CF are made, debated and decided as [GitHub issues][github_issues] in three repositories: - 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. +* [Vocabulary issues][github_vocabularies], in the [vocabularies repository](https://github.com/cf-convention/vocabularies), for proposing additions or amendments to standard names, their definitions, or other CF controlled vocabulary (area types and standardized regions). [Open a new issue](https://github.com/cf-convention/vocabularies/issues/new/choose). See also [closed vocabulary issues][github_vocabularies_closed]. -* [Website and governance][github_website] + 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 issues][github_conventions], in the [conventions repository](https://github.com/cf-convention/cf-conventions), for proposing enhancements and reporting defects in the CF conventions. [Open a new issue](https://github.com/cf-convention/cf-conventions/issues/new/choose). See also [closed conventions issues][github_conventions_closed], classified by reason for closure: [change agreed][github_conventions_change] • [agreement not to change][github_conventions_nochange] • [dormant][github_conventions_dormant]. "Dormant" means 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. - For discussing, proposing changes and reporting defects in the [CF website][website] or CF governance. +* [Website and governance issues][github_website], in the [website repository](https://github.com/cf-convention/cf-convention.github.io), for proposing changes and reporting defects in the [CF website][website] or CF governance. [Open a new issue](https://github.com/cf-convention/cf-convention.github.io/issues/new/choose). -No registration with CF is required to contribute; all that is needed is a freely available [GitHub account][github]. +You can enable notifications of updates to issues for each kind of issue separately using the Watch menu in its repository. ### 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. +Announcements, discussions and Q&A that were initiated before CF GitHub Discussions began are continuing as GitHub issues in the `discuss` repository. They will soon be converted to GitHub Discussions. + +Before the CF community migrated to GitHub: + +* until December 2019, general discussion took place and standard names were proposed on the [cf-metadata mailing list][archives] ([original at NCAR][NCAR_archives]). + +* until July 2018, changes to the conventions were proposed on the [CF Metadata Trac][about] site. -* cf-metadata mailing list archive [copy on GitHub][archives] or [original at NCAR][NCAR_archives] (until December 2019) -* [CF Metadata Trac](Data/trac.html) (until July 2018) -* [About CF Metadata Trac][about] [github_conventions]: https://github.com/cf-convention/cf-conventions/issues +[github_conventions_closed]: https://github.com/cf-convention/cf-conventions/issues?q=is:issue+is:closed [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_discuss]: https://github.com/cf-convention/discuss/issues [github_vocabularies]: https://github.com/cf-convention/vocabularies/issues +[github_vocabularies_closed]: https://github.com/cf-convention/vocabularies/issues?q=is:issue+is:closed [github_website]: https://github.com/cf-convention/cf-convention.github.io/issues [github]: https://github.com [website]: https://cfconventions.org @@ -55,4 +60,8 @@ 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 +[github_qa]: https://github.com/orgs/cf-convention/discussions/categories/q-a-about-using-cf +[github_comment]: https://github.com/orgs/cf-convention/discussions/categories/comments-and-ideas-for-changing-cf +[github_announce]: https://github.com/orgs/cf-convention/discussions/categories/announcements-relevant-to-cf diff --git a/index.md b/index.md index 951e2cac..92e29eb6 100755 --- a/index.md +++ b/index.md @@ -12,14 +12,13 @@ The CF convention includes a standard name table, which defines strings that ide --- -**_Conventions_:** **Latest release** (1.11) [HTML][releasedhtml] [PDF][releasedpdf] - •  +[**_Ask a question_ about how to use CF**  ❓][github_askq] + +**_Read the conventions_:** **Latest release** (1.11) [HTML][releasedhtml] [PDF][releasedpdf] •  **Working draft** [HTML][workinghtml] [PDF][workingpdf] -**_Vocabularies_:** [**Standard names**][currentnames] - •  -[**Area types**][areatypes] - •  +**_Check the latest vocabularies_:** [**Standard names**][currentnames] •  +[**Area types**][areatypes] •  [**Standardized regions**][regions] --- @@ -66,3 +65,4 @@ See also the links in the navigation bar at the top of this page. [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 +[github_askq]: https://github.com/orgs/cf-convention/discussions/new?category=q-a-about-using-cf