Skip to content

Commit dcf2dc5

Browse files
committed
Merge branch 'main' of github.com:cf-convention/cf-convention.github.io
2 parents c7f44b2 + 8f67e7a commit dcf2dc5

14 files changed

+372
-3
lines changed

Committees/Conventions_and_Standard_Names/meeting-minutes.md renamed to Committees/Conventions_and_Standard_Names/committee_meeting_minutes.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,5 @@ title: CF Conventions Committee and Standard Names Committee Minutes
55

66
# CF Conventions Committee and Standard Names Committee Minutes
77

8-
* [2023-09-29 CF Conventions Committee and Standard Names Committee meeting](2023-09-29-meeting.md)
8+
* [2025-01-27 CF Conventions Committee and Standard Names Committee meeting](committee_meeting_minutes_2025-01-27.md)
9+
* [2023-09-29 CF Conventions Committee and Standard Names Committee meeting](committee_meeting_minutes_2023-09-29.md)
Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
---
2+
layout: default
3+
title: 2025-01-27 CF Conventions Committee and Standard Names Committee meeting
4+
---
5+
# 2025-01-27 CF Conventions Committee and Standard Names Committee meeting
6+
7+
## Attendees
8+
9+
Jonathan, David, Lars, Seth, Alison, Roy, Fran, Philip, Karl, Luke, Ellie
10+
11+
12+
## Agenda
13+
14+
1. Consolidation and revision of rules
15+
2. Who qualifies to be named in the list of authors?
16+
3. Three-week conventions "cooling off" periods
17+
4. Is one week enough for the final approval of standard names, or should it be three weeks?
18+
5. How we agree changes
19+
6. When we should revisit changes
20+
7. Our relationship to other standards
21+
22+
23+
## Discussion
24+
25+
### Schedule our next meeting
26+
27+
* DECISION: Some time in April 2025.
28+
29+
### 1. Consolidation and revision of rules
30+
31+
* In August 2024 it was suggested in [issue 369](https://github.com/cf-convention/cf-conventions/issues/369) to consolidate a list of open procedural issues.
32+
* Issue 369 was not discussed in detail, rather we wanted to remind ourselves that the issue exists, and whether we're happy with its current proposed framework.
33+
* DECISION: Issue 369 should be pursued.
34+
35+
### 2. Who qualifies to be named in the list of authors?
36+
37+
* This is relevant to the PR template, and it's not written it down anywhere.
38+
* To date we've added people as authors who've drafted text to enhance the convention.
39+
We have not added people for suggesting improvements or ideas (not text), nor for correcting defects.
40+
* DECISION: The committee has discretion to authorship, but the general rule is that you will have opened an issue and contributed significant text.
41+
42+
### 3. Three-week conventions "cooling off" periods
43+
44+
* At a recent Governance Panel meeting, it was suggested that we could announce the start of three-week conventions "cooling off" periods, as announcements in the discuss repository, for those who don't subscribe to the conventions repository.
45+
As a partial alternative, it was suggested that whenever we fork a conventions issue from a discussion, we should invite people who are interested to be kept informed by mentioning themselves on the issue.
46+
* The right time to bring people's attention is at the transition from discussion to issue (rather than when the issue is concluded), by inviting people to subscribe to the new issue (which you can do without commenting).
47+
* Working practices should be in the FAQ and README.
48+
* Could ask committee members themselves to provide administrative (not scientific) moderation to make all this happen. This might include ensuring that continued discussion happened in the right place (i.e. on the new issue).
49+
* No concrete decision.
50+
51+
### 4. Is one week enough for the final approval of standard names, or should it be three weeks?
52+
53+
* The 1 week period was originally instigated as a compromise, reflecting that standard name discussions are generally shorter and easier than conventions changes.
54+
Wrapping things and publishing in a timely manner is nice and useful for the community.
55+
* With 1 week you can easily get caught out by being on vacation, etc.
56+
Is 2 weeks a better compromise?
57+
* With a longer delay we don't tend to get more comments, so a longer time could seem like a needless delay.
58+
* The risk of missing one person's contribution is relatively low in a standard name discussion. It's unlikely that the new name will be "wrong", and we have means for correcting mistakes.
59+
* DECISION: No change to the current rule.
60+
61+
### 5. How we agree changes
62+
63+
* We do this by consensus.
64+
Our rules show that this does not mean unanimous support (which allows for people who don't mind, or haven't followed, to accept the general decision).
65+
It means absence of objection to the agreed text, plus a requirement for some explicit support.
66+
The only expertise we have to assure quality is our process of discussion.
67+
* We also have a rule that if the discussion reaches an impasse, it can go to a meeting of the committee.
68+
The committee has never yet needed to make decision in this way.
69+
* When a discussion gets very polarised, we should take a step back and appoint a neutral moderator to try to break the impasse.
70+
* DECISION: No change to rules.
71+
72+
### 6. When we should revisit changes
73+
74+
* Recent discussions ([#400](https://github.com/orgs/cf-convention/discussions/400) and [#401](https://github.com/orgs/cf-convention/discussions/401) have suggested alternative ways of doing things that are already in the CF conventions.
75+
* We have a design principle of "a strong preference against introducing any new capability to the conventions when there is already some method that can adequately serve the same purpose (even if a different method would arguably be better than the existing one)", the aim of which is to limit the complexity of CF, and because all previous conventions must continue to be supported for the sake of archived datasets.
76+
* For the existing standard (i.e. CF-1.x), stability is more important than fixing imperfections. Alternative approaches that address imperfections are possibly a case for CF-2.x.
77+
* It is hard for some communities to get into aspects of CF (particularly standard names) when they are failing to get what they want due to the way things have been done to date. The landscape has changed since 2003, so re-evaluating old decisions is not a bad thing.
78+
* Just saying "we don't do it like that" is not always constructive, especially when it doesn't provide any solutions.
79+
* People often use layers of standards, e.g. netCDF - CF - [SeaDataNet](https://www.seadatanet.org)/[CMIP](https://www.wcrp-climate.org/wgcm-cmip). CF provides the solid foundations on which others can build.
80+
However, such layers are fine only up to the point when what needs to be built on CF needs to modify parts of CF itself.
81+
82+
### 7. Our relationship to other standards
83+
84+
* If CF wants to include something for which there is already a convention, should it be re-implement in a "CF-way", or just say "we follow convention X".
85+
There are pros (e.g. we don't need to reinvent a wheel) and cons (e.g. convention X will certainly evolve, and we have to keep track of that) with both approaches.
86+
* One case where we have done this is with the biological taxa, which defers to a well defined authority.
87+
Another is UDUNITS (following COARDS).
88+
* We should ask ourselves if we can map between other standards (interoperability, sufficiently distinct). This is a separate question as to whether our representation looks exactly like another standard.
89+
* Different standards have different purposes, and you can't be interoperable with every standard. The purpose of CF is to make our data usable, and that trumps interoperability if need be.
90+
* Where does CF end, and other standards begin? So long as we're clear where we are in relation to these things, that's OK. We don't have to represent everything within CF ourselves.
91+
* We should embrace the fact that other communities have often thought about things more deeply than we have, and take advantage of that.
92+
* This sort of question might be well served by forming off-line discussion groups (as has been successful in the past).
93+
* DECISION: We will set up an offline discussion group for the question of interoperability between the CF calendars and OGC/ISO.
94+
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
layout: default
3+
title: 2024-12-05 CF Governance Panel meeting
4+
---
5+
# 2024-12-05 CF Governance Panel meeting
6+
7+
## Attendees
8+
Karl, Jonathan, Ethan, Bryan
9+
10+
## Agenda/Notes
11+
12+
* Schedule our next meeting (early March?)
13+
* 13 March 2025 9am MT (backup 11 March)
14+
* Update on AGU award, talk, etc.
15+
* Update on Roadmap activities
16+
* Discussed three publications
17+
* Roadmap in ESSD (Roadmap group)
18+
* Proceedings in BAMS (Workshop organizing committee)
19+
* Retrospective in EOS (CF Governance Panel)
20+
* short history of CF \- include projects that use CF
21+
* Also future directions
22+
* Audience, how broad: EOS, Nature, Science Data, AGU Advances?
23+
* Timeline: spring/summer next year?
24+
* Rough outline: History, CMIP, last few years of innovation, roadmap, some figures showing growth of standard names, changes in the data model, method of working.
25+
Aim for something with a DOI so maybe not EOS.
26+
* Public comment period
27+
* Should 3-week rule for significant changes to CF Convention (enhancements?) include broader announcements than in the relevant GH Issue, perhaps as a Discussion?
28+
* Suggestion: If issue/PR comes from a Discussion, that is a good location to announce the 3-week period.
29+
* Suggestion: Explicitly mention that an issue has started from a Discussion, subscribe to that issue to follow (or express interest on that issue will also get you all notifications.
30+
* Similar to when a working group is spun off, mention that decision will be made by work group. Announce and give 3-weeks. (Can’t relitigate issues already decided.)
31+
* CF Standard Names has 7-day wait period. Too short? Committee will discuss.
32+
* Begin planning for 2025 CF Workshop (virtual)
33+
* Two part meeting? In-person meetings only? Advantages to virtual in terms of attendance by people that can’t travel.
34+
* ACTION: Ethan will email 2024 org committee to start discussion
35+
* Using CF with Zarr and how this relates to GeoZarr
36+
* Related CF issue: \#[259](https://github.com/cf-convention/discuss/issues/259) (closed)
37+
* Bryan: NCAS(?) has pure Python implementation of netCDF reader

Governance/GovPanel/meeting-minutes.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@ title: CF Governance Panel Minutes
55

66
# CF Governance Panel Meeting Minutes
77

8+
* [2024-12-05 CF Governance Panel Meeting](2024-12-05-meeting.md)
89
* [2024-09-09 CF Governance Panel Meeting](2024-09-09-meeting.md)
910
* [2024-06-10 CF Governance Panel Meeting](2024-06-10-meeting.md)
1011
* [2024-03-04 CF Governance Panel Meeting](2024-03-04-meeting.md)
Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
---
2+
layout: default
3+
title: 2024-03-11 CF Information Management and Support Team meeting
4+
---
5+
# 2024-03-11 CF Information Management and Support Team meeting
6+
7+
## Attendees
8+
Andrew Barna, Sadie Bartholomew, Antonio S. Cofiño, Francesca Eggleton, Ellie Fisher, David Hassell, Rosalyn Hatcher, Alison Pamment, Daniel Lee, Jonathan Gregory
9+
10+
## Agenda/Notes
11+
12+
* Decide on how often to hold regular meetings of the info-mgmt team
13+
* Quarterly
14+
* Schedule next meeting of the info-mgmt team
15+
* Wednesday 5 June 2024 at 15:00 UTC
16+
* How to communicate as team? emails, other?
17+
* GH Team Discussions were sunset (see [GH blog post](https://github.blog/changelog/2023-02-08-sunset-notice-team-discussions/) announcement)
18+
* Email
19+
* Initial (test) migration to GH Discussions instead of CF Discuss issues
20+
* See issue #[440](https://github.com/cf-convention/cf-conventions/issues/440) and Gov Panel notes from Dec 2023 mtg
21+
* Test setup announcement by Jonathan (see Issue #[290](https://github.com/cf-convention/discuss/issues/290) and Discussion #[289](https://github.com/orgs/cf-convention/discussions/289)).
22+
* Fran - tested GH Discussions - would like to demonstrate some potential problems
23+
* Changes to website and templates for new issues
24+
* Can discussions be made into issues in other repos? Need to test.
25+
* Do we even want to create issue from discussion topic?
26+
* Or summarize agreed issue in new Issue.
27+
* See “Reference in new issue” option in Discussion comment menu option
28+
* Actions:
29+
* All: More testing
30+
* Jonathan: summarize this discussion in Discussion forum
31+
* New (renamed) CF Standard Names repo
32+
* Discuss new repo (transfer SN Issues) vs renaming discuss (transfer non SN into Discussions)
33+
* Two pieces:
34+
* Documents, etc. that want to store/track in git
35+
* Discussion
36+
* Alison: no need to move standard name docs out of website repo
37+
* Ethan: DOIs might be easier; website space issues
38+
* Alison: How to re-architect how standard names are handled in GH?
39+
40+
## Hold for next meeting
41+
42+
* Build/release process
43+
* Can we control the files archived during a release?
44+
* For instance, PDF and HTML.zip instead of .zip of repo contents?
45+
* Suppress output from link checker if there are no problems to report
46+
47+
## Hold for separate (or next) meeting
48+
49+
* DOI and License
50+
* Add license information to header/footer of web pages (issue https://github.com/cf-convention/cf-convention.github.io/issues/116)
51+
* Add license information to CF Conventions docs, HTML and PDF (issue https://github.com/cf-convention/cf-convention.github.io/issues/182)
52+
* Author/contributor lists
53+
* Goal: One machine readable copy used to auto-generate lists in docs
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
layout: default
3+
title: 2024-06-05 CF Information Management and Support Team meeting
4+
---
5+
# 2024-06-05 CF Information Management and Support Team meeting
6+
7+
## Attending
8+
Jonathan Gregory, Ethan Davis, Andrew Barna, Sadie Bartholomew, Francesca Eggleton, David Hassell, Gui Castelao, Alison Pamment, Antonio S. Cofiño
9+
10+
## Agenda/Notes
11+
12+
* Schedule next meeting of the info-mgmt team
13+
* 3 Sept at 15:00 UTC
14+
* Review [notes](2024-03-11-meeting.md) from last meeting (11 March), for agenda items for this meeting
15+
* Link Checker: Discussion #[320](https://github.com/orgs/cf-convention/discussions/320) “Broken web links”
16+
* \[Antonio\]: Re-open issue on error?
17+
* \[Antonio\]: After error, report “no-error” status and close issue automatically?
18+
* Jonathan suggests only open on error, close by hand.
19+
* **Decision**: Open automatically, close manually.
20+
* \[Antonio\]: Long action: Check and take actions on excluded paths and/or links
21+
* **Decision**: Repost broken links that we know that they are definitely broken/missing
22+
* Should CF info-mgmt team meetings be open and advertised in CF Discussion?
23+
* Ask for input on agenda items in the announcement?
24+
* Publish Agenda/Notes or minutes?
25+
* Stick with GDocs? On CF website? On CF GitHub Wiki?
26+
* Discuss:
27+
* Alison: advertise agenda ahead of time, open if interested.
28+
* David: discussed in conventions meeting \- announce and invite if interested (email for meeting link)
29+
* Gui: agree, maybe not expressly invite unless requested, just to not slow things down too much.
30+
* Andrew: are issues opened on all topics we discuss.
31+
* Alison: Do we need process to track issues that should be discussed here.
32+
* Sadie: Could we use a label(s) to indicate
33+
* David: voting should be team members only
34+
* **Decision**: advertise agenda ahead of time. (issue/discuss/wiki?). Discussion “announce” tag.
35+
* Allow external participants if requested.
36+
* Review new DOIs for CF Conventions document and the DOI metadata
37+
* **Decision**: Build/release process should add PDF (and HTML ?) files to GitHub Release
38+
* Metadata
39+
* **Action**: Add DOI to CITATION.CFF
40+
* **Action**: Review .zenodo.json, compare to DOI metadata
41+
42+
## Hold for next meeting
43+
44+
* CF Conventions document build draft/release process
45+
* Draft versions need to be clarified that “CF-\<version\>-draft” is not valid in ‘Conventions’ attribute (See Discussion \#[321](https://github.com/orgs/cf-convention/discussions/321))
46+
* Author/contributor lists
47+
* Goal: One machine-readable copy used to auto-generate lists in docs
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
layout: default
3+
title: 2024-09-03 CF Information Management and Support Team meeting
4+
---
5+
# 2024-09-03 CF Information Management and Support Team meeting
6+
7+
## Attendees
8+
Andrew Barna, Lars Bärring, Guilherme Castelao, Antonio S. Cofiño, Ethan Davis, Francesca Eggleton, Ellie Fisher, Jonathan Gregory, Daniel Lee, Alison Pamment
9+
10+
## Agenda/Notes
11+
12+
* Schedule next meeting of the info-mgmt team
13+
* 3rd Dec at 15:00 UTC
14+
* CF Workshop hackathon planning
15+
* GH Permissions: CF org members, teams, permissions, external collaborators
16+
* **Decisions:**
17+
* \[**Done**\] Delete ‘conventions’ and ‘Web’ teams
18+
* \[**Done**\] Remove a few no longer active members from organization
19+
* Review content and make ‘cf-training’ repo public. Consider folding into web site.
20+
* \[**Done**\] Remove webtest1 repo
21+
* \[**Done**\] Downgrade info-mgmt to ‘maintenance’ from ‘admin’
22+
* \[**Done**\] Give committees and panel Write permission
23+
* \[**Done**\] Owners: good with the current three (Ethan, David, Daniel)
24+
* \[**Done**\] Change ‘Contributor’ team name to “Moderator’
25+
* Collaborator role:
26+
* Moderator role (for issues) needs permissions to modify/edit the initial post.
27+
*
28+
* CF Conventions document build draft/release process
29+
* Draft versions need to be clarified that “CF-\<version\>-draft” is not valid in ‘Conventions’ attribute (See Discussion \#[321](https://github.com/orgs/cf-convention/discussions/321))
30+
* Agreement reached, we think. Issue and PR needed
31+
* Author/contributor lists
32+
* Goal: One machine-readable copy used to auto-generate lists in docs
33+
* Possible Hackathon topic?
34+
* The following three open conventions issues are all technical matters, and they have stalled.
35+
Would anyone volunteer to adopt any of them?
36+
(Sadie opened the first two, but that doesn't oblige her to complete them\!)
37+
* Color blindness accessibility of document figures & tables (Issue #[404](https://github.com/cf-convention/cf-conventions/issues/404))
38+
* Appendix F: 14 geotiff.maptools.org domain links redirecting (Issue #[479](https://github.com/cf-convention/cf-conventions/issues/479))
39+
* Formatting of local links in text; Lists of Figures, Tables and Examples (Issue #[499](https://github.com/cf-convention/cf-conventions/issues/499))
40+
* At its meeting today, the committee thought it would be useful to have some very short and simple instructions about how to "check and merge a PR", if requested to do so.
41+
The "check" part means casting your eye over it, just to see that it changes the files in reasonable ways, doesn't delete any files unexpectedly or cause other accidental damage.
42+
It doesn't mean checking the content beyond that, because we don't merge until the content has been agreed in detail.
43+
There are some committee members who might do this when requested, but don't know how.
44+
* Issue #[151](https://github.com/cf-convention/cf-conventions/issues/151) on moderation of proposals contains some agreement that it would be a good idea for moderators of proposals to be able to update the initial posting in an issue, to add links to summaries or key points in the discussion.
45+
To update someone else's post requires write permission to the repo, which not everyone has.
46+
Would it be reasonable and practical to give write permission to the conventions repo to anyone who volunteers as a moderator?

0 commit comments

Comments
 (0)