Skip to content

Commit 4e119a7

Browse files
committed
rfc, future-work: rename section to 'Future possibilities' + consequence edits.
1 parent f879a53 commit 4e119a7

File tree

1 file changed

+34
-31
lines changed

1 file changed

+34
-31
lines changed

text/0000-future-work.md

Lines changed: 34 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
- Feature Name: `future_work`
1+
- Feature Name: `future_possibilities`
22
- Start Date: 2018-10-11
33
- RFC PR: _
44
- Rust Issue: N/A. The RFC is self-executing.
55

66
# Summary
77
[summary]: #summary
88

9-
Adds a *"Future work"* section to the `0000-template.md` RFC template that
10-
asks authors to elaborate on what natural extensions there might to their
9+
Adds a *"Future possibilities"* section to the `0000-template.md` RFC template
10+
that asks authors to elaborate on what natural extensions there might to their
1111
RFC and what future directions this may take the project into.
1212
This section asks authors to think *holistically*.
1313

@@ -19,9 +19,9 @@ This section asks authors to think *holistically*.
1919
Often times, when an RFC is written, the only thing an author considers
2020
may be the feature or change proposal itself but not the larger picture
2121
and context in which the RFC operates in. By asking the author to reflect
22-
on future work, a larger degree of introspection within the author themselves
23-
may ensue. The hope is then that they may consider what larger effects
24-
their proposal may have and what subsequent proposals may be.
22+
on future possibilities, a larger degree of introspection within the author
23+
themselves may ensue. The hope is then that they may consider what larger
24+
effects their proposal may have and what subsequent proposals may be.
2525

2626
[#2532]: https://github.com/Centril/rfcs/blob/rfc/assoc-default-groups/text/0000-assoc-default-groups.md#future-work
2727
[#2529]: https://github.com/Centril/rfcs/blob/rfc/hidden-impls/text/0000-hidden-impls.md#future-work-1
@@ -33,17 +33,17 @@ their proposal may have and what subsequent proposals may be.
3333
[#2385]: https://github.com/Centril/rfcs/blob/rfc/implied-derive/text/0000-implied-derive.md#future-work
3434
[#2306]: https://github.com/rust-lang/rfcs/blob/master/text/2306-convert-id.md#possible-future-work
3535

36-
The author of this RFC has benefitted personally from writing future-work
36+
The author of this RFC has benefitted personally from writing future-possibilities
3737
sections ([#2532], [#2529], [#2524], [#2523], [#2522], [#2401], [#2421],
3838
[#2385], and [#2306]). Said written sections have also caused the current
3939
author to think more clearly about interactions in each of the written RFCs.
40-
If for no other reason, these sections offer a permantent space to idea-dump
40+
If for no other reason, these sections offer a permanent space to idea-dump
4141
while writing an RFC.
4242

4343
## For the team
4444

45-
The holistic perspective that a future work section can offer may also
46-
help the relevant subteam to understand:
45+
The holistic perspective that a future-possibilities section can offer may also
46+
help the relevant sub-team to understand:
4747

4848
1. why something is proposed,
4949
2. what the long term effects of said proposal is,
@@ -54,17 +54,17 @@ help the relevant subteam to understand:
5454

5555
More generally, the benefits for the teams described above also hold for
5656
all readers. In particular, a reader can better infer what sort of language
57-
Rust is turning into given the information in a future-work section.
57+
Rust is turning into given the information in a future-possibilities section.
5858
Having such a section may also help generate interest in subsequent proposals
5959
which a different author may then write.
6060

6161
# Guide-level explanation
6262
[guide-level-explanation]: #guide-level-explanation
6363

64-
This Meta-RFC modifies the RFC template by adding a *"Future work"* section
65-
after the *"Unresolved questions"*. The newly introduced section is intended
66-
to help the authors, teams and readers in general reflect holistically on
67-
the big picture effects that a specific RFC proposal has.
64+
This Meta-RFC modifies the RFC template by adding a *"Future possibilities"*
65+
section after the *"Unresolved questions"*. The newly introduced section is
66+
intended to help the authors, teams and readers in general reflect holistically
67+
on the big picture effects that a specific RFC proposal has.
6868

6969
Please read the [reference-level-explanation] for exact details of what an
7070
RFC author will see in the changed template.
@@ -75,24 +75,24 @@ RFC author will see in the changed template.
7575
The implementation of this RFC consists of inserting the following text to the
7676
RFC template *after* the section *Unresolved questions*:
7777

78-
> # Future work
78+
> # Future possibilities
7979
>
8080
> Think about what the natural extension and evolution of your proposal would
8181
> be and how it would affect the language and project as a whole in a holistic
8282
> way. Try to use this section as a tool to more fully consider all possible
8383
> interactions with the project and language in your proposal.
8484
> Also consider how the this all fits into the roadmap for the project
85-
> and of the relevant subteam.
85+
> and of the relevant sub-team.
8686
>
8787
> This is also a good place to "dump ideas", if they are out of scope for the
8888
> RFC you are writing but otherwise related.
8989
>
90-
> If you have tried and cannot think of any future work, you may simply state
91-
> that you cannot think of anything.
90+
> If you have tried and cannot think of any future possibilities,
91+
> you may simply state that you cannot think of anything.
9292
>
93-
> Note that having something written down in the future-work section is not
94-
> a reason to accept the current or a future RFC; such notes should be in the
95-
> section on motivation or rationale in this or subsequent RFCs.
93+
> Note that having something written down in the future-possibilities section
94+
> is not a reason to accept the current or a future RFC; such notes should be
95+
> in the section on motivation or rationale in this or subsequent RFCs.
9696
> The section merely provides additional information.
9797
9898
# Drawbacks
@@ -106,11 +106,11 @@ There's some risk that the section will simply be left empty and unused.
106106
However, in the recent RFCs written by the author as noted in the [motivation],
107107
this has not been a problem. On the contrary, the very idea behind adding
108108
this section has come as a result of the experience gained by writing
109-
such future-work sections in the aforementioned RFCs.
109+
such future-possibilities sections in the aforementioned RFCs.
110110

111111
However, some of the RFCs written by the this RFC's author have not had such
112112
sections. Therefore, if an RFC leaves the newly introduced section empty,
113-
it is not the end of the world. The section is inteded as encouragement and
113+
it is not the end of the world. The section is intended as encouragement and
114114
recommendation; it is not mandatory as no section in an RFC has ever really been.
115115

116116
## Higher barrier to entry
@@ -123,10 +123,10 @@ This can raise the barrier to entry somewhat.
123123
However, we argue that it is worth the minor raise in the bar since
124124
it is OK for RFCs to leave the section empty.
125125

126-
## Readers reacting negatively on the future work
126+
## Readers reacting negatively on the future possibilities
127127

128128
Another potential drawback is that readers of the RFC will focus too much
129-
on what is written in the future-work section and not the actual proposal
129+
on what is written in the future-possibilities section and not the actual proposal
130130
that is made in the RFC. This has not been the case in the RFCs mentioned
131131
in the [motivation].
132132

@@ -136,7 +136,10 @@ in the [motivation].
136136
1. We could rephrase the section in various ways.
137137
It is possible to do such tweaking in the future.
138138

139-
2. We could rename it but the proposed name is customary.
139+
2. We could rename it to "possible future work" or "future work" where the latter
140+
is more customary, but we have opted to use a section title that makes it more
141+
clear that the contents of the section are not what is accepted but only
142+
*possibilities*.
140143

141144
3. We could move the section up and down and around.
142145

@@ -150,17 +153,17 @@ in the [motivation].
150153

151154
None of the languages enumerated in [RFC 2333] have such a section proposed
152155
in this RFC. However, there are plenty of academic papers published which
153-
do contain sections pertaining to future work. It is customary for such
154-
sections to be at the end of papers so as to not bore readers and keep
156+
do contain sections pertaining to future possibilities. It is customary for
157+
such sections to be at the end of papers so as to not bore readers and keep
155158
them reading.
156159

157160
# Unresolved questions
158161
[unresolved-questions]: #unresolved-questions
159162

160163
None as of yet.
161164

162-
# Future work
163-
[future-work]: #future-work
165+
# Future possibilities
166+
[future-possibilities]: #future-possibilities
164167

165168
[staged]: http://smallcultfollowing.com/babysteps/blog/2018/06/20/proposal-for-a-staged-rfc-process/
166169

0 commit comments

Comments
 (0)