I'm reading the CBSubs docs and for the most part, I'm loving them. They've been very helpful in resolving the vast majority of my questions.
There is, however, a recurring issue I am raising here because I was encouraged to do so. I'm told that the Joomlapolis crowd actively seeks constructive feedback.
I'll use a
very simple example here, just to illustrate the point. On a yes/no parameter, many times one can know the impacts, or quickly test the results.
I raise this as an issue NOT about the example given, but rather to open a discussion about the concept of describing field-use and parameters. I'll leave it to you to imagine what might happen on a more complex (or sensitive) parameter.
Page 129:
Parameter: selected by default: initial value: ‘No’
This ‘Yes/No’ drop-down field parameter is used to specify if this plan is to be selected by default.
That explanation is simply a longer repetition of the parameter itself. The phrase "by default" can have different meanings in different contexts. It leaves one wondering:
Selected by default by whom? Where? Selected by CBSubs to display on the page? Selected by the browser? Selected by the user? Why does this parameter matter - what does it do? How many "default" plans can I display? just one? multiples? if multiples, is there a limit?
What I'm looking for in documentation are the decision-making criteria for setting this parameter (and others) one way or the other. How do I know whether to set this to yes or to no?
Tell me here:
"This plan will be included among those automatically displayed ("by default") on the registration page. Multiple plans (up to 12) may be shown and you'll use the xyz parameter to put them in order (see page xxx for information on the xyz parameter)."
or tell me:
"One plan will be automatically marked as the "selected" option (the radio button will be filled for this plan and no others) when a visitor comes to the registration page. This "default plan" is what the visitor will join, unless that visitor specifically selects a different plan (by clicking into the radio button for another plan). Only one plan can be the default selection, so choose wisely."
This would help me know how to decide, or at least what happens, when I make various decisions about the parameter.