Could you please tell me more about Markdown? Me i have writen with the software OpenOffice, it have taken me many video search tutorials and viewing, still i am open to suggestions; as long that it is softwares that are full (no trial or limitations) free and mostly legal.
From OpenOffice i have converted and exported as pdf. This because pdf i do think is some universal format, there are softwares that can open and read this type of file; it is for many operating systems as windows, mac, linux, android, iphone, tablettes.
When i do some pdf guides with OpenOffice, i not only use this software, i have softwares to create some images and make designs. Like i could put the godotengine face image (keeping its properties, mentionning that it belong to them; and that i’m simply a user of the software). Brief give them the credits and respect them.
If you look this old guide dated many years. You should notice that i have done a header and footer. I have done a top design and bottom design of the pages. I have put a background look, that i have covered with some white with alpha transparency percentage, so that i can show the background; and at the same time put things over as text and images.
I have thinked about the page number and total page number count. Have made that what ever page the user is, when the user click the link to go to the table of content; then it do as so. The elements in the header and footer auto-repeat it self and auto-ajust. Example i dont have to write each page number it does it automaticly.
I had to think the printscreens quality (dpi) images to put in the pages. So that the total weight of the pdf is not much big, but that the image is of good quality when peoples zoom in and zoom out; so i had to optimize as best as i can (but not too much or it could go fast pixelated). Have think to do some arrows or/and draw circles pointing things in the images and giving explications, so that anyone can easy follow.
For the table of content i had to make it auto-update for the content that are in the pages, so when i add content i just update the table of content. I had also to think the formating of the table of content, formating of the titles, formating of the text, etc. Had to think the parenting tree of the bookmarks as the thumbnails, when you open or close the bookmarks or thumbnails you should notice that i even have think about the bookmarks. Again in the table of content i had to not only indicate the subject, but indicate on what page it is; even make it clickable if a user want to go directly to the subject.
Also i had to do some thinking about putting my self in the beginner shoes, explaning each step and explaining steps to do. Many times trough the year i have buy paper books, even looked free guides online; but notice that it was not easy to follow and not enough well explained. I had to also try my self my own teaching, because it is important for me that it is real easy for anyones.
Sometimes i have seen some books “For Dummies” example: Coding this coding language (for dummies). After opening the book, it say that (this book is for peoples that have some basics in coding), but the categorie is “For Dummies”. That’s weird the book say for dummies, and opening the book, this book say (you must have some programming knowledges or others). So why it is said “For Dummies”?