search

Lexpedite / blawx

A user-friendly web-based tool for Rules as Code.
MIT License
105 stars 9 forks source link

Language issues in tutorial #384

Closed Gauntlet173 closed 1 year ago

Gauntlet173 commented 2 years ago

There is a lot of awkward language that needs to be revised to be clearer.

The text does not indicate where blocks should be placed.

The text does not advise people to watch the gif.

The text uses block names out of context, it should include images or refer to the gif for examples of what they look like.

Not clear that "first text field" is not the dropdown.

not clear how customization block knows which attribute it is customizing

Missing quotations

Doesn't indicate that order of adding blocks is unimportant.

Doesn't say how to expand explanation tree.

Doesn't indicate there is no navigation tree in the test interface.

Not clear what "defeated" and "refuted" mean in the explanations.

Numerous typos: "eligible" not "age", "blank" not "black", "eligible" not "entitled", "attached" not "attacked", "drawer" not "block", "5" not "6"

Gauntlet173 commented 1 year ago

The tutorial was removed in 1.4.0-alpha