@@ -124,7 +124,7 @@ it's unlikely we'd end up with a complete, consistent, properly maintained speci
124
124
125
125
So this RFC proposes that we ask the Rust Foundation to coordinate and take responsibility
126
126
for the parts of the work that would otherwise not get done.
127
- The foundation should hire a technical editor (or perhaps multiple people)
127
+ The foundation should hire a technical editor
128
128
who will work with the Rust teams and contributors to create the Rust specification.
129
129
The editor will be responsible for maintaining the document and will coordinate with the relevant teams
130
130
(e.g. the language team, the operational semantics team, the compiler, the types team, the library API team, and so on)
@@ -133,6 +133,55 @@ to collect all relevant information and make sure that consensus is reached on e
133
133
The relevant Rust teams keep authority on their respective parts of Rust.
134
134
The Rust Foundation supports and coordinates the work, but the Rust teams will remain in charge of what Rust is.
135
135
136
+ ## Role of the Editor
137
+
138
+ The role of the editor is more than just a technical writer; the editor will be a leader in the specification development process.
139
+
140
+ The tasks of the editor (as [ suggested by Joel] ( https://github.com/rust-lang/rfcs/pull/3355#issuecomment-1481813621 ) ):
141
+
142
+ 1 . * Active coordination and management of the specification process* .
143
+ Working with project members, an editor dedicated to the specification will
144
+ work to ensure that there is continuous progress on the specification itself,
145
+ through activities like coordinating meetings, suggesting relevant topics of
146
+ discussion, managing the infrastructure around the creation of the
147
+ specification.
148
+
149
+ 2 . * Collecting and aggregating information from spec-relevant Project teams* .
150
+ Related to the coordination and management of the process, the editor will have
151
+ an ear in all the relevant Project teams that have members working on the
152
+ specification in order to understand their thoughts, ideas and requirements.
153
+ The editor will aggregate this information to use during the specification
154
+ process. The editor will work closely with Project teams such as the Language
155
+ team, the Operational Semantics team, etc. to ensure, for example,
156
+ specification proposals can be officially approved for inclusion into the
157
+ specification. To be clear the editor is not necessarily a member of any
158
+ particular team, but will work with those teams to ensure they are represented
159
+ well and fairly in the specification.
160
+
161
+ 3 . * Technical writing* .
162
+ The editor actually has to incorporate the concepts and write the words that
163
+ will ultimately make up the specification. The reason that this is not
164
+ necessarily the top priority is that without the coordination and information
165
+ gathering, this cannot be done in any meaningful way. But, obviously, this is
166
+ where the rubber meets the road and where the final output will be made. The
167
+ editor, in conjunction with any potential required ancillary design or
168
+ copyediting resources, will produce a developer and community friendly Rust
169
+ language specification.
170
+
171
+ 4 . * Reporting progress* .
172
+ Since not everyone in the Project will be involved in the specification process
173
+ on a daily basis and with the expected interest within the Rust community, the
174
+ editor will provide regular status updates on the progress of the
175
+ specification. The vehicle by which this will be done is to be determined, but
176
+ you can imagine public blog posts, a dedicated Zulip stream, etc.
177
+
178
+ 5 . * Propose technical clarifications and corrections to the specification* .
179
+ As we work on the specification, there is a reasonable probability that we may
180
+ find areas that are unclear, confusing and maybe even contradictory. While not
181
+ a hard requirement and more of a nice-to-have, optimally the editor will be
182
+ well-versed in programming languages and can offer potential clarifications and
183
+ corrections for technical correctness and consistency purposes.
184
+
136
185
# Questions deliberately left open
137
186
138
187
This RFC deliberately leaves many questions open, to be answered later in the process.
0 commit comments