You are right of course,
I will admit that, because I jumped pretty straight into working with the better Archetype designer to do some “learning by doing” in the beginning it probably took me a bit too long to actually find and read the style guide. I mostly relied on learning from published Archetypes.
My bad of course, and I have read the style guide in the meantime. But maybe it would be good if new users of the Better Archetype designer were more actively nudged towards reading the style guide users before they start working?
If a new Archetype editor user clicks on “new Archetype” for the very first time it might be good occasion to have a popup directing them to the style guide.
Some section specific nudges in the editing interface may also be a good idea, i.e. a link next to the “use” section editing interface pointing to the relevant sections of the style guide may be a good addition if it implemented in a way that’s not obstructive for experienced users.
My thinking is that any effort to actively instruct users to write good use sections from the start could reduce the effort needed to “tidy up” later.
@heather.leslie thoughts?