herbk wrote: ↑Mon Jan 29, 2018 9:02 am
But some questions to the panels...:
On most Operations we have two different panels where the parameters are to change. One (the gray like on the pic above) which i get on starting a operation and the Data Box.
Both boxes don't have the same contend and some operations don't have the gray box. To give the help pages a structure which is near the structure of FC, i want to seperate the description to.
The 'property pane', which all objects have, comes from FreeCAD. It will always have all the properties of the object exposed. The task panels are from Path. We designed them to be clean, easy to use, and intuitive. Sometimes we chose to leave off more 'advanced' features to achieve this goal.
My opinion (and it's just an opinion) is that we shouldn't try to document the GUI. If we're relying on pictures to show which properties exist and their location/relation to each other, then we're making a mistake. GUIs can change over time and pictures are hard to edit. So they tend to become obsolte fast. I also think users are smart enough to hunt around without relying on a picture.
Instead, we should document the option, what they mean and how they interact. This should be in text whenever possible. Text is easy to translate and also easy to edit so more likely to stay up-to-date.
There's obviously good reasons to use pictures but always ask yourself; 'is this picture likely to be meaningful in the next version?'
