Skip to content

Commit 06fd0ce

Browse files
committed
Roles: Add sub-roles for infrastructure
and other related updates.
1 parent 7efd0f5 commit 06fd0ce

File tree

1 file changed

+130
-103
lines changed

1 file changed

+130
-103
lines changed

roles.json

Lines changed: 130 additions & 103 deletions
Original file line numberDiff line numberDiff line change
@@ -207,29 +207,110 @@
207207
}
208208
},
209209
{
210-
"role": "Documentation infrastructure maintainer",
211-
"url": "Documentation_infrastructure_maintainer",
210+
"role": "Infrastructure Team",
211+
"url": "Infrastructure_team",
212+
"role-head": "Infrastructure Team",
213+
"sub-roles": [
214+
{
215+
"role": "DevOps and Operations Specialist",
216+
"people": [
217+
"E. Madison Bray",
218+
"Pey Lian Lim",
219+
"Brigitta Sip\u0151cz"
220+
]
221+
},
222+
{
223+
"role": "CI Infrastructure",
212224
"people": [
213225
"Simon Conseil",
214226
"Pey Lian Lim",
215227
"Thomas Robitaille",
216228
"Brigitta Sip\u0151cz"
217-
],
218-
"role-head": "Documentation infrastructure maintainer",
219-
"responsibilities": {
220-
"description": "Maintain the <a href='http://docs.astropy.org/en/stable/index.html'>Astropy documentation</a> website, including:",
221-
"details": [
222-
"Managing the Sphinx infrastructure",
223-
"Implementing changes and improvements to the documentation website",
224-
"Overseeing content (although primary responsibility for content lies with subpackage maintainers)"
225-
]
229+
]
230+
},
231+
{
232+
"role": "Documentation Infrastructure",
233+
"people": [
234+
"Simon Conseil",
235+
"Pey Lian Lim",
236+
"Thomas Robitaille",
237+
"Brigitta Sip\u0151cz"
238+
]
239+
},
240+
{
241+
"role": "Metrics",
242+
"people": ["Unfilled"]
243+
},
244+
{
245+
"role": "Website and Data",
246+
"people": [
247+
"Adrian Price-Whelan",
248+
"Erik Tollerud"
249+
]
250+
}
251+
],
252+
"responsibilities": [
253+
{
254+
"subrole-head": "DevOps and Operations Specialist",
255+
"description": "Ensure the smooth running of the project:",
256+
"details": [
257+
"Perform initial triaging of issues and pull requests, including moving between repositories in the project.",
258+
"Perform first responder duties across the project, including guiding first-time contributors.",
259+
"Monitor the health of the project in terms of development and operations; if necessary, also alert the relevant project members of any issues and/or formulate responses.",
260+
"Monitor the CI statuses and promptly report any CI breakage to the relevant project members.",
261+
"Merge non-controversial pull requests in the project.",
262+
"Liaison with other projects that share similar infrastructure."
263+
]
264+
},
265+
{
266+
"subrole-head": "CI Infrastructure",
267+
"description": "Lead development and maintenance of the continuous integration (CI) testing infrastructure for Astropy, including:",
268+
"details": [
269+
"Set up and maintain continuous integration services.",
270+
"Managing issues/pull request for the astropy core package regarding testing infrastructure.",
271+
"Managing issues/pull requests in the repositories containing the testing plugins, and determining when new plugins are required.",
272+
"Maintaining the 'metapackage' with the testing machinery (pytest-astropy at the time of this writing).",
273+
"Maintaining the visualization tests data in astropy-figure-tests repository.",
274+
"Supporting and enabling affiliated package usage of the testing infrastructure."
275+
]
276+
},
277+
{
278+
"subrole-head": "Documentation Infrastructure",
279+
"description": "Maintain the <a href='https://docs.astropy.org/en/stable/index.html'>Astropy documentation</a> website, including:",
280+
"details": [
281+
"Managing the Sphinx infrastructure, theme, and plugins.",
282+
"Managing the ReadTheDocs infrastructure.",
283+
"Maintaining the 'metapackage' with the documentation machinery (sphinx-astropy at the time of this writing).",
284+
"Implementing changes and improvements to the documentation website.",
285+
"Overseeing content (although primary responsibility for content lies with subpackage maintainers)."
286+
]
287+
},
288+
{
289+
"subrole-head": "Metrics",
290+
"description": "Manage the tools needed for project metrics:",
291+
"details": [
292+
"Run benchmarks (mostly the core package) and publish results at a frequent cadence.",
293+
"Maintain the benchmark tools.",
294+
"Managing pull requests to the benchmark repository.",
295+
"Stretch goal: Lead the effort to revive project dashboard."
296+
]
297+
},
298+
{
299+
"subrole-head": "Website and Data",
300+
"description": "Manage the <a href='https://astropy.org'>astropy.org</a> website, including:",
301+
"details": [
302+
"Maintaining contributor/roles list.",
303+
"Managing pull requests to the website repository.",
304+
"Managing <a href='http://data.astropy.org'>data.astropy.org</a>, which is done by managing the astropy-data repository (which is automatically synced with <a href='http://data.astropy.org'>data.astropy.org</a>).",
305+
"Managing the astropy.org DNS entries and related domain name upkeep."
306+
]
226307
}
308+
]
227309
},
228310
{
229311
"role": "Affiliated package review editor",
230312
"url": "Affiliated_package_review_editor",
231313
"people": ["Derek Homeier", "William Jamieson"],
232-
"deputy": ["Unfilled"],
233314
"role-head": "Affiliated package review editor",
234315
"responsibilities": {
235316
"description": "Oversee the affiliated package submission and review process, including:",
@@ -241,63 +322,6 @@
241322
]
242323
}
243324
},
244-
{
245-
"role": "Astropy.org web page maintainer",
246-
"url": "Astropyorg_web_page_maintainer",
247-
"people": [
248-
"Adrian Price-Whelan",
249-
"Erik Tollerud"
250-
],
251-
"role-head": "Astropy.org web page maintainer",
252-
"responsibilities": {
253-
"description": "Manage the <a href='http://astropy.org'>astropy.org</a> web site, including:",
254-
"details": [
255-
"Maintaining contributor/roles list",
256-
"Managing pull requests to the website repository",
257-
"Managing <a href='http://data.astropy.org'>data.astropy.org</a>, which is done by managing the astropy-data repository (which is automatically synced with <a href='http://data.astropy.org'>data.astropy.org</a>)",
258-
"Managing the astropy.org DNS entries and related domain name upkeep"
259-
]
260-
}
261-
},
262-
{
263-
"role": "DevOps and Operations Specialist",
264-
"url": "devops_team",
265-
"people": [
266-
"E. Madison Bray",
267-
"Pey Lian Lim",
268-
"Brigitta Sip\u0151cz"
269-
],
270-
"role-head": "DevOps and Operations",
271-
"responsibilities": {
272-
"description": "Ensure the smooth running of the project",
273-
"details": [
274-
"Set up and maintain continuous integration services",
275-
"Ensure adequate labeling of issues and pull requests",
276-
"Perform initial triaging of issues and pull requests, including moving between repositories",
277-
"Merge non-controversial pull requests"
278-
]
279-
}
280-
},
281-
{
282-
"role": "Testing infrastructure maintainer",
283-
"url": "Testing_infrastructure_maintainer",
284-
"people": [
285-
"Simon Conseil",
286-
"Pey Lian Lim",
287-
"Thomas Robitaille",
288-
"Brigitta Sip\u0151cz"
289-
],
290-
"role-head": "Testing infrastructure maintainer",
291-
"responsibilities": {
292-
"description": "Lead development and maintenance of the testing infrastructure for Astropy and the helpers, including:",
293-
"details": [
294-
"Managing issues/pull request for the Astropy core package regarding testing infrastructure",
295-
"Managing issues/pull requests in the repositories containing the testing plugins, and determining when new plugins are required",
296-
"Maintaining the 'metapackage' with the testing machinery (pytest-astropy at the time of this writing)",
297-
"Supporting and enabling affiliated package usage of the testing infrastructure"
298-
]
299-
}
300-
},
301325
{
302326
"role": "Package template maintainer",
303327
"url": "Packagetemplate_maintainer",
@@ -360,39 +384,28 @@
360384
"responsibilities": {
361385
"description": "Oversee the release process for packages in the project, including:",
362386
"details": [
363-
"Carrying out releases of the core astropy package",
364-
"Notifying the Distribution Coordinators of any core astropy package release",
365-
"Working with the Community Engagement Coordinator to make release announcements via channels such as mailing lists and social media",
366-
"Keeping documentation for the release process of the core package up to date",
367-
"Designing policies to improve the uniformity of release procedures for the coordinated and infrastructure packages of the Astropy Project",
368-
"Testing the interoperability of the core, coordinated, and infrastructure packages and provide safeguards against breaking the ecosystem."
369-
]
370-
}
371-
},
372-
{
373-
"role": "Core astropy package maintainer (general)",
374-
"url": "Core_package_general_maintainer",
375-
"people": [
376-
"Derek Homeier",
377-
"Pey Lian Lim"
378-
],
379-
"role-head": "Core astropy package maintainer (general)",
380-
"responsibilities": {
381-
"description": "Maintain the astropy core package in aspects that are not specific to a single sub-package",
382-
"details": [
383-
"Evaluating new pull requests for quality, API consistency, Astropy coding standards, and appropriateness within the overall astropy ecosystem, in particular for pull requests spanning multiple sub-packages",
384-
"Merging Pull Requests that are non-controversial or after reaching out to relevant subpackage maintainers",
385-
"Maintain, review, and advocate for useful interaction between multiple sub-packages",
386-
"Perform initial triaging of issues and pull requests",
387-
"Keeping track of frequent contributors and their relevant areas of expertise"
387+
"Carrying out releases of the core astropy package.",
388+
"Notifying the Distribution Coordinators of any core astropy package release.",
389+
"Working with the Community Engagement Coordinator to make release announcements via channels such as mailing lists and social media.",
390+
"Keeping documentation for the release process of the core package up to date.",
391+
"Designing and carrying out policies to improve the uniformity of release procedures for the coordinated and infrastructure packages of the Astropy Project.",
392+
"Testing the interoperability of the core, coordinated, and infrastructure packages and provide safeguards against breaking the ecosystem.",
393+
"Applying updates and fixes to the build process and the release infrastructure (e.g., extension-helpers, sphinx-changelog, pyinstaller) as needed."
388394
]
389395
}
390396
},
391397
{
392-
"role": "Core astropy package maintainer (sub-package)",
393-
"url": "Subpackage_maintainer",
394-
"role-head": "Sub-package maintainer (at least one per core package sub-package)",
398+
"role": "Core astropy package maintainer",
399+
"url": "Core_package_maintainer",
400+
"role-head": "Core astropy package maintainer",
395401
"sub-roles": [
402+
{
403+
"role": "General",
404+
"people": [
405+
"Derek Homeier",
406+
"Pey Lian Lim"
407+
]
408+
},
396409
{
397410
"role": "astropy.constants",
398411
"people": [
@@ -537,16 +550,30 @@
537550
]
538551
}
539552
],
540-
"responsibilities": {
553+
"responsibilities": [
554+
{
555+
"subrole-head":"Core astropy package maintainer (general)",
556+
"description": "Maintain the astropy core package in aspects that are not specific to a single sub-package:",
557+
"details": [
558+
"Evaluating new pull requests for quality, API consistency, Astropy coding standards, and appropriateness within the overall Astropy ecosystem, in particular for pull requests spanning multiple sub-packages.",
559+
"Merging pull requests that are non-controversial or after reaching out to relevant subpackage maintainers.",
560+
"Maintain, review, and advocate for useful interaction between multiple sub-packages.",
561+
"Perform initial triaging and ensure adequate labeling of issues and pull requests.",
562+
"Keeping track of frequent contributors and their relevant areas of expertise."
563+
]
564+
},
565+
{
566+
"subrole-head":"Core astropy sub-package maintainer (at least one per sub-package)",
541567
"description": "Maintain a sub-package of the astropy core package, including:",
542568
"details": [
543-
"Evaluating new pull requests for quality, API consistency, Astropy coding standards, and appropriateness within the overall astropy ecosystem",
544-
"Merging Pull Requests in the sub-package",
545-
"Keeping track of the \u201cbig picture\u201d progress of the sub-package - includes new feature development and significant bugs",
546-
"Perform initial triaging of issues and pull requests",
547-
"Keeping track of frequent contributors to the sub-package and their relevant areas of expertise"
569+
"Evaluating new pull requests for quality, API consistency, Astropy coding standards, and appropriateness within the overall Astropy ecosystem.",
570+
"Merging Pull Requests in the sub-package.",
571+
"Keeping track of the \u201cbig picture\u201d progress of the sub-package - includes new feature development and significant bugs.",
572+
"Perform initial triaging and ensure adequate labeling of issues and pull requests.",
573+
"Keeping track of frequent contributors to the sub-package and their relevant areas of expertise."
548574
]
549575
}
576+
]
550577
},
551578
{
552579
"role": "Coordinated package maintainer",

0 commit comments

Comments
 (0)