"FreeCAD scripting guide" - Proof reader needed

A place to share learning material: written tutorials, videos, etc.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

"FreeCAD scripting guide" - Proof reader needed

Post by onekk »

Hello, I'm here to ask for proof readers.

I have wrote a "FreeCAD scritping guide" in Italian, and I'm in the process to make an "English version".

It was mostly a "complete rework", but my main problem is that "I'm not an English speaker" and my writing skills in English are not "too good".

So I ask you to read the include PDF file and maybe tell me if it is correct and is comprehensible.

EDIT see most recent version in https://github.com/onekk/freecad-doc/tr ... r/English

The guide is deprecated and have removed from the site.

Many thanks in advance and please apologize me for the bad English.

Regards

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:21 pm, edited 4 times in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by onekk »

See above.

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:22 pm, edited 4 times in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
TheMarkster
Veteran
Posts: 5505
Joined: Thu Apr 05, 2018 1:53 am

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by TheMarkster »

Page I -- Have a nice job with FreeCAD.
I'm not sure how to translate that. Do you mean have fun with FreeCAD? Do a good job with FreeCAD? Maybe, enjoy working with FreeCAD?
Page II - Version numbering is done according to the software release scheme, in other word, non
definitive version have a version number starting with 0.
First ”finished” version will be 1.0 and so on.
To be in sync with the ”original” italian version this guisde is starting from 0.50
I would say:

Version numbering is done according to the software release scheme, in other words, non
definitive versions have a version number starting with 0.
First ”finished” version will be 1.0 and so on.
To be in sync with the ”original” Italian version this guide is starting from 0.50.


I will continue when I have more time.
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by onekk »

TheMarkster wrote: Fri Jan 07, 2022 5:58 am I will continue when I have more time.

Many thanks, I will integrated soon your changes.

EDIT new version link on GitHub Page

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by onekk »

See above.

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:22 pm, edited 1 time in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
EdgarRobles
Posts: 72
Joined: Fri Jul 31, 2015 1:35 pm
Location: Mexico
Contact:

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by EdgarRobles »

onekk wrote: Sun Jan 09, 2022 4:35 pm New Version 0.54a on GitHub page.

I will thank Kunda1 and TheMarkster for the help.

I hope that now is a decent introduction, at least for complete beginners, as there is some thing to work on and some code to use as test, some exercises are suggested in the text.

Maybe now the work less quick, some improvement are already in preparation, but Holidays are ended.

Stay Tuned for more in next days, maybe at end of next week some more will be posted on GitHub..

Regards

Carlo D.
Hi Carlo.
Congratulations for this amazing work.
We EdgarRobles and jruiz are 2 members of Freecad en español group
If you don't mind, we would like to translate your guide to Spanish. What do you think about that?. Is there any way to get your latex source code in order to start a spanish version?
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Proof reader needed for a "FreeCAD scripting guide"

Post by onekk »

See above.

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:23 pm, edited 1 time in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: "FreeCAD scripting guide" - Proof reader needed

Post by onekk »

See above.

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:23 pm, edited 1 time in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
alodk
Posts: 1
Joined: Sat Feb 12, 2022 2:52 pm

Re: "FreeCAD scripting guide" - Proof reader needed

Post by alodk »

I have some changes to the English text, but I have not finished the first reading.

I have downloaded the PDF (GFC-Eng_v_0.55alpha.pdf) and if you can do a diff(compare) on the two files, you can look the changes and see if you want to keep them.

I live in Denmark, but I use English almost every day.

I don't know Phyton, so I will ignore the <code>.

On GitHub:
https://github.com/alodk

Regards
Anders
User avatar
onekk
Veteran
Posts: 6149
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: "FreeCAD scripting guide" - Proof reader needed

Post by onekk »

alodk wrote: Sat Feb 12, 2022 3:13 pm ...
Thanks, for help, but where is the file?

on your GitHub page there is nothing related.


Regards

Carlo D.
Last edited by onekk on Thu Nov 03, 2022 3:23 pm, edited 1 time in total.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.

Blog: https://okkmkblog.wordpress.com/
Post Reply