Open Community (TDC) Meeting, Thursday 09 March 2023

[github-actions]

NOTE: This meeting is on Thursday at 9am - 10am PT

Zoom Meeting link: https://zoom.us/j/975841675. Dial-in passcode: 763054 - Code-of-Conduct

In order to give some more visibility into the topics we cover in the TDC meetings here is the planned agenda for the next meeting. Hopefully this will allow people to plan to attend meetings for topics that they have an interest in. And for folks who cannot attend they can comment on this issue prior to the meeting. Feel free to suggest other potential agenda topics.

Please submit comments below for topics or proposals that you wish to present in the TDC meeting

The agenda backlog is currently maintained in issue #2482

Topic	Owner	Decision/NextStep
Reports from Special Interest Groups	TDC
AOB (see below)	TDC
New issues / PRs labelled review	@OAI/triage
New issues without response yet	@OAI/triage

/cc @OAI/tsc Please suggest items for inclusion

[handrews]

I know that there's a policy of not changing previously released documents, but does this really make sense when the links within to documents cease to function because of changes in Markdown rendering by GitHub or URL wtfery by the IETF?

Fixing these is essentially restoring the originally published behavior, which is now broken, providing bad UX to anyone who looks at the nominally authoritative renderings on GitHub.

There are currently 3 PRs attempting to address the GitHub problems:

• Internal link refactor to be more resilient across different markdown renderers #3128 @SethAngell (versions/3.1.1.md on v3.1.0-dev) fixes all
• Fix anchors/links in markdown [3.1.0.md] #3136 @vksepm (versions/3.1.0.md on main) only fixes pathItemObject
• Update Relative Links to Sections #3160 @kexoth (versions/3.0.3.md on main) fixes all, requested to port to 3.0.4

There is one issue, one merged PR, and one unmerged PR about the IETF links

• The links to RFC3339 stopped working #3146 (Issue) Notes problems with 3339, but not the broken 1866 w/trailing slash
• Update 3.0.4.md to fix broken links #3029 @mojorero (versions/3.0.3.md on main) fixes 3339 but not 1866
• Fix broken RFC links #3188 @handrews (versions/3.0.4.md on v3.0.4-dev, merged) fixes all

[handrews]

To follow up on last week's discussion, let's decide if #3187 is the right approach to explaining byte/binary usage (especially paging @MikeRalphson ).

If approved, I will write a corresponding PR for 3.1.1 (the details of which will be quite different because of contentMediaType/contentEncoding).

[karenetheridge]

I would update old specs purely to fix bad links, or obvious spelling errors that do not impact the meaning of what is being said. I agree that keeping dead links is a bad look.