Volunteers: Unfinished Wiki pages for Part Workbench
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
Be nice to others! Respect the FreeCAD code of conduct!
Re: Volunteers: Unfinished Wiki pages for Part Workbench
I'll PM you later to discuss some minor issues.
But for now: I see that you are adding huge images (2.240 x 1.164 pixels). IMO they are not necessary. But if you want to add them, please crop them.
See WikiPages and also GuiCommand_model.
But for now: I see that you are adding huge images (2.240 x 1.164 pixels). IMO they are not necessary. But if you want to add them, please crop them.
See WikiPages and also GuiCommand_model.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
Great! Appreciate.
I use a ‚normal‘ MBP with retina screen. Maybe a bit to much resolution.
Got your hint and read and understood the graphics part. I will update the pictures in the next days.
I use a ‚normal‘ MBP with retina screen. Maybe a bit to much resolution.
Got your hint and read and understood the graphics part. I will update the pictures in the next days.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
In version V0.20 you can also use this:
Code: Select all
from BasicShapes import Shapes
Shapes.addTube(FreeCAD.ActiveDocument, "Tube")
Re: Volunteers: Unfinished Wiki pages for Part Workbench
I updated the Part Box with patient help and answering questions from @Roy_043.
If there is conclusion I will use this as a template and start working on the other Part Objects.
If there is conclusion I will use this as a template and start working on the other Part Objects.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
Thanks but the page does not exactly reflect what we have discussed.
Notably:
The Notes paragraph and the Example paragraph are superfluous IMO.
The Base group of proprieties is inherited and should not be mentioned.
Some other remarks:
This is incorrect as the image does show the orientation:
The described placement and orientation changes are not shown because of simplicity for the given example.
Not sure what you mean here:
By default, a box is created with three sides (edges) of equal length, each one 10 mm long.
This can be easily recognized by the additional check mark at the icon in the tree view. See Overlay Icons.
The check mark has nothing to do with the dimensions of the box.
Notably:
The Notes paragraph and the Example paragraph are superfluous IMO.
The Base group of proprieties is inherited and should not be mentioned.
Some other remarks:
This is incorrect as the image does show the orientation:
The described placement and orientation changes are not shown because of simplicity for the given example.
Not sure what you mean here:
By default, a box is created with three sides (edges) of equal length, each one 10 mm long.
This can be easily recognized by the additional check mark at the icon in the tree view. See Overlay Icons.
The check mark has nothing to do with the dimensions of the box.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
Hopefully. There are less small different views to some points. I came from a FreeCAD 'beginners' point of view and think maybe different to a FreeCAD pioneer or forum veteran.
The first goal is to make an accepted 'template' to use for the other objects too.
At the end, we should find a good base to start the rest of the work, otherwise it wastes a lot of time, that can be spent better. At some point, somebody else will finish the work or reset my changes. Who knows?!
You are right. I correct this. I came back to use the placement and orientation values, because of the preferred given picture ratio of the small right pictures from the wiki.
Changed it.Roy_043 wrote: ↑Wed Feb 16, 2022 10:31 am Not sure what you mean here:
By default, a box is created with three sides (edges) of equal length, each one 10 mm long.
This can be easily recognized by the additional check mark at the icon in the tree view. See Overlay Icons.
The check mark has nothing to do with the dimensions of the box.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
You should decide where the default dimensions and placement of the object are described. They should be described only once, either in the Description or in the Usage paragraph. Duplicate information should always be avoided. Nobody wants to read 3x (!) that a default Part Box is 10x10x10.
The Part Primitives that have a dedicated command (all commands with a yellow icon, except Part Tube) can also be created with the Part Primitives command. With that command you can specify the dimensions and the placement at creating time. That would be a useful note for the Notes paragraph.
Note that the name of an object is NOT user editable.
See Part_Feature#Name and Object name.
The Part Primitives that have a dedicated command (all commands with a yellow icon, except Part Tube) can also be created with the Part Primitives command. With that command you can specify the dimensions and the placement at creating time. That would be a useful note for the Notes paragraph.
Note that the name of an object is NOT user editable.
See Part_Feature#Name and Object name.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
Until today I thought, that I shouldn't change the complete Part Box entry. But when I think more and more about our discussion and your inputs, the I should hit the 'reset' button and make a simple, clear and straightforward text without repetition. I will structure a text and fill it in this afternoon or evening.Roy_043 wrote: ↑Thu Feb 17, 2022 12:58 pm You should decide where the default dimensions and placement of the object are described. They should be described only once, either in the Description or in the Usage paragraph. Duplicate information should always be avoided. Nobody wants to read 3x (!) that a default Part Box is 10x10x10.
Thanks for the hint. I will read the text later and work out a wording.Roy_043 wrote: ↑Thu Feb 17, 2022 12:58 pm The Part Primitives that have a dedicated command (all commands with a yellow icon, except Part Tube) can also be created with the Part Primitives command. With that command you can specify the dimensions and the placement at creating time. That would be a useful note for the Notes paragraph.
Got it. I will change this later to a clear and good explanation.
Sorry for the circumstances.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
Thanks for your work so far.
I see that you have edited the Usage paragraph on the Part Box page in such a way that it no longer matches the GuiCommand model page. That is not a good idea. We want the Wiki to be (more) consistent, that is why the GuiCommand model page was created. Please follow that model more closely.
We have discussed the Notes paragraph on the Part Box page a number of times. As it stands now it would be deleted in the editing process.
There are still things that are not completely how they should be, but I can fix those later.
I see that you have edited the Usage paragraph on the Part Box page in such a way that it no longer matches the GuiCommand model page. That is not a good idea. We want the Wiki to be (more) consistent, that is why the GuiCommand model page was created. Please follow that model more closely.
We have discussed the Notes paragraph on the Part Box page a number of times. As it stands now it would be deleted in the editing process.
There are still things that are not completely how they should be, but I can fix those later.
Re: Volunteers: Unfinished Wiki pages for Part Workbench
No prob. I learned a lot.
I will correct this to the GuiCommandModel.Roy_043 wrote: ↑Sat Feb 19, 2022 4:14 pm I see that you have edited the Usage paragraph on the Part Box page in such a way that it no longer matches the GuiCommand model page. That is not a good idea. We want the Wiki to be (more) consistent, that is why the GuiCommand model page was created. Please follow that model more closely.
You do not have to do it. I will delete all Notes paragraphs that are obsolete.
I spent hours of my time on it and if the speed is to slow for you, just feel free to do it. Just write me, if my work is not needed anymore, then I'll move on to my couch and do other things.