Since the wiki version is tranlateable within the wiki and can easily be enhanced by wiki-writers i would opt for this way ...yorik wrote:2) We consider the wiki as a fork. In any case, there will be no way to update the printed version, so there will be several versions out there anyway.
The FreeCAD manual
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
Be nice to others! Respect the FreeCAD code of conduct!
Re: The FreeCAD manual
Deutsche FreeCAD Tutorials auf Youtube
My GrabCAD FreeCAD-Projects
FreeCAD lessons for beginners in english
Native german speaker - so apologies for my english, no offense intended
My GrabCAD FreeCAD-Projects
FreeCAD lessons for beginners in english
Native german speaker - so apologies for my english, no offense intended
Re: The FreeCAD manual
Yes, basically for me this whole thing was an experience... To see if I was able to write a book, and to see how different it was to have documentation written by a single person. Now I saw these two things I think the "master" should be the wiki. When 0.17 will be out, a good part of the book will be outdated. I'm not sure at all I'll have time to change the book, so it has more chances to keep up to date on the wiki...
Re: The FreeCAD manual
Hi there,
Ok, that makes sense too. Wiki editing is easier so this means the chances of getting contributions/translations is indeed higher.
Ok, that makes sense too. Wiki editing is easier so this means the chances of getting contributions/translations is indeed higher.
Re: The FreeCAD manual
For me, Yorik's opinion is 'master' here . Also the reason is good:I think the "master" should be the wiki
But, if you really plan to have the whole book reviewedWhen 0.17 will be out, a good part of the book will be outdated. I'm not sure at all I'll have time to change the book, so it has more chances to keep up to date on the wiki...
I think we may have many other small changes upcoming. Do you intend to edit the wiki then, and use the wiki as the basis for publishing? This is risky, as the wiki is by nature constantly evolving. You need a frozen version for publishing. So I would suggest to incorporate the part you think meaningful of my comments (many are typos or straightforward errors so probably not much to discuss there) as well as your reviewer's version in the master (github for the moment). BTW I'm sorry I don't know any experienced native speaker that could do the job (more than in the publishing, he/she probably should have some CAD experience, as the language is technical here, even if the book is aimed at novices - but not only!)make it reviewed by a native english speaker who has experience in the publishing business.
I can help there as well for my part, as soon as you review my comments, forking on github (silly me, I had that intention at first, then I was misled by quickly looking at gitbook in thinking there was no github source attached).
Ciao
Enrico
Re: The FreeCAD manual
Yes, that's the planediloren wrote:So I would suggest to incorporate the part you think meaningful of my comments (many are typos or straightforward errors so probably not much to discuss there) as well as your reviewer's version in the master (github for the moment)
An editor who speaks CAD will be hard to find but I think if I find someone who already worked with tech books, that should be all right...ediloren wrote:he/she probably should have some CAD experience, as the language is technical here
Re: The FreeCAD manual
yorik wrote:Yes, that's the planediloren wrote:So I would suggest to incorporate the part you think meaningful of my comments (many are typos or straightforward errors so probably not much to discuss there) as well as your reviewer's version in the master (github for the moment)
An editor who speaks CAD will be hard to find but I think if I find someone who already worked with tech books, that should be all right...ediloren wrote:he/she probably should have some CAD experience, as the language is technical here
I have some experience with CAD software and I am prepared to read it and edit it.
- Johnquicker
- Posts: 72
- Joined: Wed Aug 15, 2018 5:50 am
- Location: Shanghai, China
- Contact:
Re: The FreeCAD manual - an native English editor?
Hello, yorik. I noticed @garya is editing the manual on some wiki pages as I was informed to update the Chinese translation. In my opinion, @garya's changes are also awesome, making the sentences more smooth to read. Are you in the process of updating the texts into FC version 0.18? Does someone have a timeline?yorik wrote: ↑Fri Sep 02, 2016 4:12 pm
I'm also in the process of preparing a printed version, to publish on lulu.com (which allows to place it on amazon and barnes and noble too). The document is almost done, but I'd like to make it reviewed by a native English speaker who has experience in the publishing business. Anyone here knows such a person?
BTW, @garya is asking about "serially reading the Manual", and I think it will be good to have the <prev> and <next> links at the end of each manual pages like the one on those normal wiki pages.
Re: The FreeCAD manual
I just added a thread about broadening the documentation on the Development forum.
https://forum.freecadweb.org/viewtopic.php?f=21&t=33223
It is aimed at generating discussion on various forms of documentation and how access to them is organised.
I support the notion that the wiki is the primary source of material as it is easily accessed by all users and editors. It works as a good repository for some of the written tutorial material and Yorik has organised the tutorial access well.
I have a certain vested interest in the development of good documentation both online and offline as I am attempting to teach a series of courses to casual users of CAD and other software to support their individual and collective projects in woodwork, metalwork and plastics (including CNC and 3D printing). These courses have to be supported by documentation that is available offline as there is no internet access for the venue.
https://forum.freecadweb.org/viewtopic.php?f=21&t=33223
It is aimed at generating discussion on various forms of documentation and how access to them is organised.
I support the notion that the wiki is the primary source of material as it is easily accessed by all users and editors. It works as a good repository for some of the written tutorial material and Yorik has organised the tutorial access well.
I have a certain vested interest in the development of good documentation both online and offline as I am attempting to teach a series of courses to casual users of CAD and other software to support their individual and collective projects in woodwork, metalwork and plastics (including CNC and 3D printing). These courses have to be supported by documentation that is available offline as there is no internet access for the venue.
OS - Linux Mint 19 & Win10 (both 64bit)
IT Training & Support (retired)
Cheers Paul
IT Training & Support (retired)
Cheers Paul
Re: The FreeCAD manual
Hello. Link to ebook versions of The FreeCAD manual on Wiki page is broken
- JoshuaCall
- Posts: 50
- Joined: Tue Dec 17, 2019 3:43 am
Re: The FreeCAD manual
I haven't created a gitbook account, so I'm not 100% sure what's on that site. But I'd recommend reading the manual on the wiki until the new manual has been finished, since the wiki is updated by the community.
Additional note: For readers who want to get the most out of the manual, I'll note the following best practices:
* Compare the in-work new manual with the manual on the wiki. Follow Yorik's progress on the new manual to see which pages have and haven't been re-written yet.
* In particular, note that the Drawing Workbench has been deprecated. See the wiki manual page for an updated, TechDraw Workbench oriented version.