Thanks for the suggestions.
Page 1, Assumptions section:
Consider adding a hyperlink in the "excellent tutorial on the Sketcher by chrisb" text that links to the forum topic
The underlined text is a hyperlink that works in LibreOffice but not in the PDF. I will find out why.
Consider using different / smaller text so that it is a bit more obvious that the footer text separate from the body text.
Good point. Only the Date and Page number is useful to people other than myself. The File info shouldn't be in the PDF although I will probably leave it there during development. It would be common sense to make the text smaller but I didn't think of it.
Page 3, Sketching section:
Consider adding a hyperlink in the "Sketcher Tutorial by chrisb" text as in Page 1.
Consider not referring to Length (Distance) Constraints as "Dimensions".
It is a hyperlink but isn't working. I need to fix it.
I was trying to include words the learner would be familiar with and was planning to move away from the word "Dimensions" further in the document but I take your point. Maybe I mention at the start of the document that "What we might generally refer to as a Dimension is referred to as a Constraint in FreeCAD. Hence you have Distance constraints, Angular constraints, Radius constraints etc. Note that you have the option of Radius or Diameter constraints."
Page 4, Fillets and Chamfers section:
Consider including a more thorough description of the Solver functions inside the "(the algoritnm..." parentheses.
I know nothing much about the Solver and its functions so I will have to study up on that and add something.
This is the ideal place to give some info on the Solver now that I have mentioned it. Not a complete description of it but enough info so that the word has some meaning instead of leaving the reader wondering what the heck Solver is. What I have said is probably a bit too basic.
Page 4, Auto constraints section:
Consider mentioning that there is an "Auto Remove Redundants" setting.
Correct "Of Degrees Freedom" typo.
I vaguely remember some reference that "Auto Remove Redundant Constraints" may have a downside but that could just me being confused. I will find out more about it and add something.
Typo fixed. I don't know how the words got rearranged. I'll blame it on a faulty keyboard. It often spells words wrongly!!!
Page 4-5, Lines and Polylines section:
Consider including a hyperlink to the wiki page: https://freecadweb.org/wiki/Sketcher_CreatePolyline
Page 6, "Create a Body" section:
Here's a shortcut: for the first Sketch in the document, just clicking the Create Sketch" tool creates a new Body and upon completion of the Create Sketch tool the new Sketch is placed inside the new Body.
Page 6: I have a Solver message that I must respond to section:
Consider ticking the "Auto Remove Redundants" tickbox to True before placing the first segment.
Sounds good but I want to know if there are any downsides so I can mention them if there are. As I have said, my memory isn't as sharp as it used to be and maybe I am wrong about a downside. Why is it an option if it is always the best way to go?
By the way, lines that are in coloured text indicate to me that I need to follow the subject up. It could be that it may be incorrect, that I need to learn more about it, that it may not be relevant or any use, or even total rubbish etc etc. The final document will probably only use colours for hyperlinks and things that the user may want to locate eg where each file Save As occurred so he can find that point and continue on from there.
I have thought of some kind of Index or Table of Contents, but at this stage I'm not sure what to list.
My first thought are new topics like the first time I create a Sketch, a Body, the External Reference tool, a Shapebinder etc. The problem with this is that I may expand on the topic somewhere else. Something I know nothing about is that maybe I can bookmark items and somehow include all references to the one topic in a reference table. That way you wouldn't have to search for all the places I might have used a Shapebinder in a different way.
I have roughly indicated what workbenches I am / will be using and will tidy this up. I can probably use headings and a Table of Contents to list some workbenches because they are pretty much separate eg Assembly, Path, TechDraw, but Part Design includes Sketcher, and I haven't got this far yet, but I understand there can be reasons to swap between Part Design, Part, and Draft so these aren't always separate as I see it at this stage.
Hopefully some of these things will sort themselves out as I learn more and write more documentation.
Another thing I need to look into is how I indicate updates and additions to the document because I don't want people helping me to have to read the whole document every time I submit it just to try to figure out what has changed. Possibly LibreOffice has the facility to put changed / added text in a different colour which I can then change back to black before the next update. So much to learn -- so little time.
I have a lot to learn about creating a worthwhile document. I don't even know if LibreOffice is the best software to use or should I be looking into something like Scribus. I find images and arrows pointing to things in LibreOffice, OpenOffice and Microsoft Office don't always finish up where they should be when I add / delete text.
The way I add icons is also a pain because they always need to have their Anchor and often Wrap options changed. Probably I'm not doing it the correct way.
Edited first para LibreOffice not LibreCAD.