Create PDT user manual with examples

[ermo]

Is your feature request related to a problem? Please describe.
PDT is not very discoverable as it stands -- it seems its audience is mostly experienced CAD users.

Describe the solution you'd like
It would be nice to have a manual that targets the casual Blender user/artist getting started with precision modeling for e.g. 3D printing projects or the like.

The manual should have plenty of examples and walkthroughs that exercise all areas of PDT's features.

[Clockmender]

Agreed, the manual needs to be produced, it is a large amount of work, so may take some time. What format should we use here?

[ermo]

Let's use github wiki Markdown format.

[Clockmender]

Can we include pictures? I am not a markdown experienced chap, more to learn!

[ermo]

Can we include pictures? I am not a markdown experienced chap, more to learn!

https://help.github.com/en/articles/about-wikis

https://help.github.com/en/articles/basic-writing-and-formatting-syntax#relative-links

The image files will need to be part of the repository. Then you can reference them with relative links AFAICT.

https://guides.github.com/features/mastering-markdown/#examples

[Clockmender]

Project started, long way to go still.

[Clockmender]

Initial pages now complete, more worked examples are required and a page on "Draughting Techniques & CAD Topology", I will attend to this after my holiday.

[ermo]

@Clockmender How far along is this in your view?

[raindropsfromsky]

Hi

I noticed that the wiki is outdated, and therefore it would confuse the readers. I wanted to open an issue about it, but then I came across this issue.

I think I can help here.

I have written 10+ whole manuals for different software. The most notable among them are the User Manual for LMMS and the Wiki for ReNamer.

I try to figure out the software myself, rather than overly loading the author. Just an introductory chat/discussion would suffice. The author does not have to worry about grammar and formatting, either. If you have already drafted a manual, I can finish it much faster.

We can start immediately and finish the manual within a week. I can keep it updated as you update the Addon, thus relieving you of that burden also.

Please let me know if you are interested.

[Clockmender]

I certainly am, under what basis would this be and how much more information would you need.

Since the WiKi was started, we have modified the software somewhat in the current release, 1.4.0.

Let me know what you thoughts are please.

Cheers, Clock.

[raindropsfromsky]

Can we chat on gmail or any other platform? You have my gmail ID but I cannot see yours.
Let us sync up directly!

[Clockmender]

Ah! I don't use gmail at all, for development I tend to use Discord, my name is:

Clockmender #4196

Is that OK for you?

[raindropsfromsky]

Clockmender #4196

Sent a friend request on Discord.
I am in Bangalore, India (IST = UTC+5:30). So we will catch up after 7 hours!