Closed stuartpb closed 6 years ago
Bountysource's reset flow's note makes me think this should maybe stick the the realm of notes for now, possibly using a consistent localizable format (#194) like Click "$1"
.
Or... have it be a list of opening.steps
, and allow description
as a type of step, alternative to click.what
, to describe actions that are more elaborate than clicking.
Of course, this doesn't strictly play well with form
, especially when these steps describe a multi-step form.
Putting this on future
because it's not really blocking anything that hard and requires a lot of thought to get right
I think click: button
and description: Gear in upper-right corner
or label: Reset Password
are fine. In the thread from the OP, I was describing not wanting to step on the toes of any HTML attributes, but the latest thinking in #126 is that any actual element attributes would go under an element
object, and so it's fine to collide with that namespace in a high-level fashion.
Actually, I'm thinking about bringing back steps
, but only as an alternative to form
, for when accessing and filling out the form is more complicated than a single form. In other words, this would be a more flexible alternative to before.form
and after.form
- and one that could accommodate discovery actions.
Also, steps would make a lot of sense, a la #120, as a first-class structure under password.reset.randomization
. Like, really... I'm thinking about coming back around on #120 for v0.2.0, just making it a bit less magic-y (ie. having it so there are always steps that describe which mechanism the site uses).
Per opws/opws-schemata#1 killing notes
, the list of prose descriptions for step-by-step directions to achieve a task described here is being introduced in opws/opws-schemata#5.
The idea of representing these steps in a more structured fashion is being considered in opws/opws-schemata#8. Per #308, further discussion around these concepts should be added as comments on existing issues, or filed as new issues, on the issue tracker for opws-schemata.
Making a separate issue for this thread.