Skip to content

Commit a6ed10a

Browse files
committed
roles complete description from json fix for astropy#194
1 parent 211efc1 commit a6ed10a

3 files changed

Lines changed: 74 additions & 105 deletions

File tree

‎js/functions.js‎

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ $( document ).ready(function(){
4040
//creating roles table from json data
4141
createRolesTable(data);
4242
//creating roles lists from json data
43-
createRolesList(data);
43+
createRolesDescription(data);
4444
};
4545

4646
function createRolesTable(roles) {
@@ -107,39 +107,47 @@ $( document ).ready(function(){
107107
$("#roles-table").append(rows);
108108
}
109109

110-
function createRolesList(roles) {
110+
function createRolesDescription(roles) {
111111
//roles is an array of objects called "role"
112-
//index marks current role with non-empty description array
113-
var index = 0;
112+
var blocks = "";
114113
roles.forEach(function (role) {
115114
//role is an object containing information about each team role
116-
//checking if role["description"] array isn't empty
117-
if (role["description"].length != 0) {
118-
var list = '';
115+
var list = "";
116+
//checking if role["sub-description"] array isn't empty
117+
if (role["sub-description"].length != 0) {
119118
//generate list by iterating over each description in the role
120-
if (index != 5) {
121-
role["description"].forEach(function (description) {
119+
if (role["description"].length == 2 && role["description"][0] instanceof Array) {
120+
//separate case for sections where
121+
//both role["description"] & role["sub-description"] contain two sub-arrays
122+
role["description"][0].forEach(function (description) {
122123
list += '<li>' + description + '</li>';
123124
});
124-
$(".roles-list").eq(index).append(list);
125-
} else {
126-
//separate case for index 5 representing tutorials & guides section
127-
//where role["description"] array contains two sub-arrays
125+
blocks += '<br/>' +
126+
'<h3 id="' + role["url"] + '">' + role["role-head"] + '</h3>' +
127+
'<strong>' + role["strong"][0] + '</strong>' +
128+
'<p>' + role["sub-description"][0] + '</p>' +
129+
'<ul>' + list + '</ul>';
130+
128131
list = '';
129-
roles[index+1]["description"][0].forEach(function (description) {
132+
role["description"][1].forEach(function (description) {
130133
list += '<li>' + description + '</li>';
131134
});
132-
$(".roles-list").eq(index).append(list);
133-
134-
list = '';
135-
roles[index+1]["description"][1].forEach(function (description) {
135+
blocks += '<br/>' +
136+
'<strong>' + role["strong"][1] + '</strong>' +
137+
'<p>' + role["sub-description"][1] + '</p>' +
138+
'<ul>' + list + '</ul>';
139+
} else {
140+
role["description"].forEach(function (description) {
136141
list += '<li>' + description + '</li>';
137142
});
138-
$(".roles-list-copy").append(list);
143+
blocks += '<br/>' +
144+
'<h3 id="' + role["url"] + '">' + role["role-head"] + '</h3>' +
145+
'<p>' + role["sub-description"] + '</p>' +
146+
'<ul>' + list + '</ul>';
139147
}
140-
index++;
141148
}
142149
});
150+
$("#roles-description").append(blocks);
143151
}
144152

145153
$('#os-selector ul').each(function(){

‎roles.json‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,104 +5,149 @@
55
"sub-role" : [],
66
"lead" : ["Tom Aldcroft", "Kelle Cruz", "Tom Robitaille", "Erik Tollerud"],
77
"deputy" : [],
8+
"role-head" : ["Coordination committee member (4 people)"],
9+
"strong" : [],
10+
"sub-description" : ["Overall coordination and management of the Astropy project, including:"],
811
"description" : ["Keeping a large-scale view of the Astropy ecosystem", "Evaluating new affiliated package submissions and review of existing affiliated packages", "Approving or rejecting Astropy APEs", "Evaluating and merging core package pull requests as needed (e.g., for sub-packages without a maintainer)", "Arbitrating disagreements in the core package, including final decisions when otherwise deadlocked", "Maintaining the list of roles and related github permissions", "Managing finances for the project", "Coordinating with NumFOCUS and other funding organizations", "Securing funding for the project via discussions and proposals to funding agencies"]
912
}, {
1013
"role" : "Ombudsperson",
1114
"url" : "Ombudsperson",
1215
"sub-role" : [],
1316
"lead" : ["Steve Crawford"],
1417
"deputy" : [],
18+
"role-head" : ["Ombudsperson"],
19+
"strong" : [],
20+
"sub-description" : ["Provide a point of contact for sensitive issues separate from the coordinating committee, including:"],
1521
"description" : ["Monitoring the <a href='mailto:[email protected]'>[email protected]</a> email account", "Solicit and provide anonymized feedback to the astropy coordination committee regarding coordination of the project", "Assist the coordination committee and community engagement coordinator with violations of the code of conduct or other ethical concerns"]
1622
}, {
1723
"role" : "Community engagement coordinator",
1824
"url" : "Community_engagement_coordinator",
1925
"sub-role" : ["Overall", "Twitter", "Facebook", "Slack", "Conferences"],
2026
"lead" : ["Kelle Cruz", "Adrian Price-Whelan", "Kelle Cruz", "Tom Robitaille", "Adrian Price-Whelan"],
2127
"deputy" : ["Unfilled", "Tom Robitaille", "Tom Robitaille, Erik Tollerud", "Unfilled", "Erik Tollerud, Tom Robitaille, Kelle Cruz"],
28+
"role-head" : ["Community engagement coordinator"],
29+
"strong" : [],
30+
"sub-description" : ["Facilitate engagement with the astropy community, including:"],
2231
"description" : ["Maintain the @astropy twitter account", "Monitor/moderate the Python Users in Astronomy Facebook group", "Keep track of/help organize conferences and workshops"]
2332
}, {
2433
"role" : "Astropy GSoC coordinator",
2534
"url" : "Astropy_GSoC_coordinator",
2635
"sub-role" : [],
2736
"lead" : ["Brigitta Sipocz"],
2837
"deputy" : ["Tom Aldcroft, Erik Tollerud"],
38+
"role-head" : [],
39+
"strong" : [],
40+
"sub-description" : [],
2941
"description" : []
3042
}, {
3143
"role" : "Learn Coordinator",
3244
"url" : "Learn_coordinator",
3345
"sub-role" : [],
3446
"lead" : ["Kelle Cruz"],
3547
"deputy" : ["Unfilled"],
48+
"role-head" : ["Learn coordinator"],
49+
"strong" : [],
50+
"sub-description" : ["Oversee the Astropy \"Learn\" ecosystem, including:"],
3651
"description" : ["Ensuring that the documentation, tutorials, and guide materials are internally consistent and cover key areas of the ecosystem", "Overseeing the maintainers for the aforementioned areas", "Organizing sprints or other events focused on Astropy learning materials"]
3752
}, {
3853
"role" : "Documentation & examples maintainer",
3954
"url" : "Documentation_&amp;_examples_maintainer",
4055
"sub-role" : [],
4156
"lead" : ["Tom Robitaille"],
4257
"deputy" : ["Erik Tollerud"],
58+
"role-head" : ["Documentation & examples maintainer"],
59+
"strong" : [],
60+
"sub-description" : ["Maintain the <a href='http://docs.astropy.org/en/stable/index.html'>Astropy documentation</a> website, including:"],
4361
"description" : ["Managing the Sphinx infrastructure", "Implementing changes and improvements to the documentation website", "Overseeing content (although primary responsibility for content lies with subpackage maintainers)"]
4462
}, {
4563
"role" : "Tutorial & guides",
4664
"url" : "Tutorial_&amp;_guides",
4765
"sub-role" : ["Infrastructure", "Content"],
4866
"lead" : ["Adrian Price-Whelan", "Lia Corrales"],
4967
"deputy" : ["Erik Tollerud", "Unfilled"],
68+
"role-head" : ["Tutorial & guides"],
69+
"strong" : [["Infrastructure maintainer"], ["Content coordinator"]],
70+
"sub-description" : [["Maintain the <a href='http://www.astropy.org/astropy-tutorials/'>Tutorials website</a>, including:"], ["Oversee the material included in Tutorials and Guides, including:"]],
5071
"description" : [["Facilitating the display and discoverability of the tutorials", "Rendering of the Jupyter notebooks", "Integrated testing of notebooks"], ["Reviewing issues and pull requests", "Soliciting new content as needed", "Working with Infrastructure Maintainers to maintain website"]]
5172
}, {
5273
"role" : "Astropy.org web page maintainer",
5374
"url" : "Astropyorg_web_page_maintainer",
5475
"sub-role" : [],
5576
"lead" : ["1Erik Tollerud"],
5677
"deputy" : ["Grant Tremblay"],
78+
"role-head" : ["Astropy.org web page maintainer"],
79+
"strong" : [],
80+
"sub-description" : ["Manage the <a href='http://astropy.org'>astropy.org</a> web site, including:"],
5781
"description" : ["Maintaining contributor/roles list", "Managing pull requests to the website repository", "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>)"]
5882
}, {
5983
"role" : "Astropy-helpers maintainer",
6084
"url" : "Astropyhelpers_maintainer",
6185
"sub-role" : [],
6286
"lead" : ["Unfilled"],
6387
"deputy" : ["Erik Tollerud, Brigitta Sipocz"],
88+
"role-head" : ["Astropy-helpers maintainer"],
89+
"strong" : [],
90+
"sub-description" : ["Lead the development and maintenance of the astropy-helpers repository, including:"],
6491
"description" : ["Managing issues/pull requests for the astropy-helpers repository", "Assisting the core package release coordinator, including performing (or helping perform) the release process for astropy-helpers during core package releases", "Performing any necessary incremental/bugfix releases between Astropy releases", "Communicating to affiliated package maintainers the availability of new versions of astropy-helpers, and assist in updating in cases where changes are not trivial"]
6592
}, {
6693
"role" : "Astropy testing maintainer",
6794
"url" : "Astropy_testing_maintainer",
6895
"sub-role" : [],
6996
"lead" : ["Dan Davella"],
7097
"deputy" : ["Erik Tollerud, Tom Robitaille"],
98+
"role-head" : ["Astropy testing maintainer"],
99+
"strong" : [],
100+
"sub-description" : ["Lead development and maintenance of the testing infrastructure for Astropy and the helpers, including:"],
71101
"description" : ["Managing issues/pull request for the Astropy core package regarding testing infrastructure", "Managing issues/pull requests in the repositories containing the testing plugins, and determining when new plugins are required", "Maintaining the 'metapackage' with the testing machinery (pytest-astropy at the time of this writing)", "Supporting and enabling affiliated package usage of the testing infrastructure"]
72102
}, {
73103
"role" : "Packagetemplate_maintainer",
74104
"url" : "Packagetemplate_maintainer",
75105
"sub-role" : [],
76106
"lead" : ["1Tom Robitaille"],
77107
"deputy" : ["Brigitta Sipocz, Larry Bradley, Adrian Price-Whelan"],
108+
"role-head" : ["Package-template maintainer"],
109+
"strong" : [],
110+
"sub-description" : ["Lead the development of maintenance of the affiliated package package-template, which is used by affiliated packages. This includes:"],
78111
"description" : ["Managing issues/pull requests in the package-template repository", "Keeping the affiliated package-template up-to-date with the astropy-helpers", "Tag new releases from time to time, and keep the TEMPLATE_CHANGES up-to-date", "Communicate any ‘releases’ with affiliated package maintainers via the astropy-affiliated-maintainers mailing list"]
79112
}, {
80113
"role" : "CI-helpers maintainer",
81114
"url" : "CIhelpers_maintainer",
82115
"sub-role" : [],
83116
"lead" : ["Brigitta Sipocz"],
84117
"deputy" : ["Unfilled"],
118+
"role-head" : ["CI-helpers maintainer"],
119+
"strong" : [],
120+
"sub-description" : ["Lead the maintenance of the ci-helpers, including:"],
85121
"description" : ["Managing issues/pull requests in the ci-helpers repository", "Responding in a timely fashion to breakages in CI caused e.g. by updates in conda, Travis, or AppVeyor, by including workarounds", "Advertise the ci-helpers beyond the astropy project and try to expand adoption"]
86122
}, {
87123
"role" : "Distribution coordinator",
88124
"url" : "Distribution_coordinator",
89125
"sub-role" : ["Conda", "Debian", "Fedora", "Gentoo", "ArchLinux", "MacPorts"],
90126
"lead" : ["Matt Craig", "Ole Streicher", "Sergio Pascual", "Sébastien Fabbro", "Médéric Boquien", "Christoph Deil"],
91127
"deputy" : ["Unfilled", "Unfilled", "Unfilled", "Unfilled", "Miguel de Val-Borro, Stuart Mumford", "Hans Moritz Günther"],
128+
"role-head" : ["Distribution coordinator (1 per distribution channel)"],
129+
"strong" : [],
130+
"sub-description" : ["Create and maintain binary distribution packages for Astropy core and affiliated packages for a specific OS or package management system."],
92131
"description" : []
93132
}, {
94133
"role" : "Core package release coordinator",
95134
"url" : "Core_package_release_coordinator",
96135
"sub-role" : [],
97136
"lead" : ["Brigitta Sipocz"],
98137
"deputy" : ["Tom Robitaille, Erik Tollerud"],
138+
"role-head" : ["Core package release coordinator"],
139+
"strong" : [],
140+
"sub-description" : ["Oversee the release process for the astropy core package, including:"],
99141
"description" : ["Performing new releases", "Coordinate releases of astropy-helpers with the astropy-helpers maintainer(s)", "Maintaining the change log and “what’s new” documentation page", "Maintaining the bugfix branches", "Updating Astropy’s PyPI entry as needed", "Working with the Community Engagement Coordinator to make release announcements via channels such as mailing lists and social media", "Notifying the Distribution Coordinators of any release", "Make sure that the package gets updated in conda and coordinate with distribution coordinators", "Keep documentation for release process up to date"]
100142
}, {
101143
"role" : "Sub-package maintainer",
102144
"url" : "Subpackage_maintainer",
103145
"sub-role" : ["astropy.constants", "astropy.convolution", "astropy.coordinates", "astropy.cosmology", "astropy.io.ascii", "astropy.io.fits", "astropy.io.misc", "astropy.io.votable", "astropy.modeling", "astropy.nddata", "astropy.samp", "astropy.stats", "astropy.table", "astropy.time", "astropy.units", "astropy.utils", "astropy.visualization", "astropy.wcs"],
104146
"lead" : ["David Shupe", "Adam Ginsburg", "Erik Tollerud", "Alex Conley", "Tom Aldcroft", "Unfilled", "1Tom Robitaille", "Unfilled", "Nadia Dencheva", "Matt Craig", "1Tom Robitaille", "Steve Crawford", "Tom Aldcroft", "Tom Aldcroft", "Marten van Kerkwijk", "Pey Lian Lim", "Larry Bradley", "Unfilled"],
105147
"deputy" : ["Marten van Kerkwijk", "Axel Donath, Larry Bradley", "Stuart Littlefair, Adrian Price-Whelan", "Unfilled", "Hans Moritz Günther", "Simon Conseil, Michael Seifert, Dan D'Avella", "Matteo Bachetti", "Pey Lian Lim", "Pey Lian Lim", "Steve Crawford, Michael Seifert", "Unfilled", "Larry Bradley", "Marten van Kerkwijk", "Marten van Kerkwijk", "Adrian Price-Whelan", "Brigitta Sipocz, Erik Tollerud", "Tom Robitaille", "Nadia Dencheva"],
148+
"role-head" : ["Sub-package maintainer (1 per core package sub-package)"],
149+
"strong" : [],
150+
"sub-description" : ["Maintain a sub-package of the astropy core package, including:"],
106151
"description" : ["Evaluating new pull requests for quality, API consistency, Astropy coding standards, and appropriateness within the overall astropy ecosystem", "Merging Pull Requests in the sub-package", "Keeping track of the “big picture” progress of the sub-package - includes new feature development and significant bugs", "Keeping track of frequent contributors to the sub-package and their relevant areas of expertise"]
107152
}
108153
]

‎team.html‎

Lines changed: 1 addition & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -112,91 +112,7 @@ <h2 id="role-responsibilities">Astropy Project Role Responsibilities</h2>
112112
roles is found in the <a href="#roles">Roles</a> section.
113113
</p>
114114

115-
<br/>
116-
<h3 id="Coordination_committee_member">Coordination committee member (4 people)</h3>
117-
<p>Overall coordination and management of the Astropy project, including:</p>
118-
<ul class="roles-list"></ul>
119-
120-
<br/>
121-
<h3 id="Ombudsperson">Ombudsperson</h3>
122-
<p>Provide a point of contact for sensitive issues separate from the coordinating committee, including:</p>
123-
<ul class="roles-list"></ul>
124-
125-
<br/>
126-
<h3 id="Community_engagement_coordinator">Community engagement
127-
coordinator</h3>
128-
<p>Facilitate engagement with the astropy community, including:</p>
129-
<ul class="roles-list"></ul>
130-
131-
<br/>
132-
<h3 id="Learn_coordinator">Learn coordinator</h3>
133-
<p>Oversee the Astropy "Learn" ecosystem, including:</p>
134-
<ul class="roles-list"></ul>
135-
136-
<br/>
137-
<h3 id="Documentation_&amp;_examples_maintainer">Documentation &amp; examples maintainer</h3>
138-
<p>Maintain the <a href="http://docs.astropy.org/en/stable/index.html">Astropy
139-
documentation</a> website, including:</p>
140-
<ul class="roles-list"></ul>
141-
142-
<br/>
143-
<h3 id="Tutorial_&amp;_guides">Tutorial &amp; guides</h3>
144-
<strong> Infrastructure maintainer </strong>
145-
<p>Maintain the <a href="http://www.astropy.org/astropy-tutorials/">Tutorials
146-
website</a>, including:</p>
147-
<ul class="roles-list"></ul>
148-
149-
<br/>
150-
<strong> Content coordinator </strong>
151-
<p>Oversee the material included in Tutorials and Guides, including:</p>
152-
<ul class="roles-list-copy"></ul>
153-
154-
<br/>
155-
<h3 id="Astropyorg_web_page_maintainer">Astropy.org web page maintainer</h3>
156-
<p>Manage the <a href="http://astropy.org">astropy.org</a> web site, including:</p>
157-
<ul class="roles-list"></ul>
158-
159-
<br/>
160-
<h3 id="Astropyhelpers_maintainer">Astropy-helpers maintainer</h3>
161-
<p>Lead the development and maintenance of the astropy-helpers repository, including:</p>
162-
<ul class="roles-list"></ul>
163-
164-
<br/>
165-
<h3 id="Astropy_testing_maintainer">Astropy testing maintainer</h3>
166-
<p>Lead development and maintenance of the testing infrastructure for Astropy and
167-
the helpers, including:</p>
168-
<ul class="roles-list"></ul>
169-
170-
<br/>
171-
<h3><a id="Packagetemplate_maintainer"></a>Package-template
172-
maintainer</h3>
173-
<p>Lead the development of maintenance of the affiliated package package-template, which
174-
is used by affiliated packages. This includes:</p>
175-
<ul class="roles-list"></ul>
176-
177-
178-
<br/>
179-
<h3 id="CIhelpers_maintainer">CI-helpers maintainer</h3>
180-
<p>Lead the maintenance of the ci-helpers, including:</p>
181-
<ul class="roles-list"></ul>
182-
183-
<br/>
184-
<h3 id="Distribution_coordinator">Distribution
185-
coordinator (1 per distribution channel)</h3>
186-
<p>Create and maintain binary distribution packages for Astropy core and
187-
affiliated packages for a specific OS or package management system.</p>
188-
189-
<br/>
190-
<h3 id="Core_package_release_coordinator">Core package release
191-
coordinator</h3>
192-
<p>Oversee the release process for the astropy core package, including:</p>
193-
<ul class="roles-list"></ul>
194-
195-
<br/>
196-
<h3 id="Subpackage_maintainer">Sub-package
197-
maintainer (1 per core package sub-package)</h3>
198-
<p>Maintain a sub-package of the astropy core package, including:</p>
199-
<ul class="roles-list"></ul>
115+
<div id="roles-description"></div>
200116
</section>
201117

202118
<section>

0 commit comments

Comments
 (0)