Skip to content

Commit 17c6cfd

Browse files
committed
rfc20: drop the attributes section
Problem: the Rv1 attributes section is used by the early Fluxion queue implementation to store the assigned queue name in the system.scheduler key, but queues are now handled differently per RFC 33. Drop the attributes section.
1 parent b3485df commit 17c6cfd

File tree

1 file changed

+3
-31
lines changed

1 file changed

+3
-31
lines changed

spec_20.rst

Lines changed: 3 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -106,16 +106,13 @@ Resource Set Format Definition
106106

107107
The JSON documents that conform to the *R* format SHALL be referred
108108
to as *R* JSON documents or in short *R* documents.
109-
An *R* JSON document SHALL consist of a dictionary with four
110-
keys: :data:`version`, :data:`execution`, :data:`scheduling` and
111-
:data:`attributes`. It SHALL be valid if and only
109+
An *R* JSON document SHALL consist of a dictionary with three
110+
keys: :data:`version`, :data:`execution`, and :data:`scheduling`.
111+
It SHALL be valid if and only
112112
if it contains the :data:`version` key and either or both the :data:`execution`
113113
and :data:`scheduling` keys. The value of the :data:`execution` key SHALL
114114
contain sufficient data for the execution system to perform its core tasks. The
115115
value of :data:`scheduling` SHALL contain sufficient data for schedulers.
116-
Finally, the value of :data:`attributes` SHALL provide optional information
117-
including but not being limited to data specific to the scheduler used to
118-
create this JSON document.
119116

120117
.. data:: version
121118

@@ -216,31 +213,6 @@ create this JSON document.
216213
protocol (RFC 27) so that it may be included in static configuration,
217214
allocated to jobs, and passed down a Flux instance hierarchy.
218215

219-
.. data:: attributes
220-
221-
The purpose of the :data:`attributes` key is to provide optional
222-
information on this *R* document. The :data:`attributes` key SHALL
223-
be a dictionary of one key: :data:`system`.
224-
225-
Other keys are reserved for future extensions.
226-
227-
.. data:: system
228-
229-
Attributes in the :data:`system` dictionary provide additional system
230-
information that have affected the creation of this *R* document.
231-
All of the system attributes are optional.
232-
233-
A common system attribute is:
234-
235-
.. describe:: scheduler
236-
237-
The value of the :data:`scheduler` key is a free-from dictionary that
238-
may provide the information specific to the scheduler used
239-
to produce this document. For example, a scheduler that
240-
manages multiple job queues may add ``queue=batch``
241-
to indicate that this resource set was allocated from within
242-
its ``batch`` queue.
243-
244216

245217
Example R
246218
=========

0 commit comments

Comments
 (0)