0003054: Sketcher - List of important but empty wiki pages that need contents

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
qurn
Posts: 51
Joined: Wed Oct 10, 2018 4:49 pm

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by qurn »

yeah could have posted it here.. i just did on the first page. Sketcher_CompConstrainRadDia
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by Kunda1 »

Thanks @qurn
So, Sketcher_CompConstrainRadDia, yea?
This is not an intuitive name. IMHO this page should redirect to an intuitive name. Anybody else agree?
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
User avatar
HarryGeier
Veteran
Posts: 1231
Joined: Mon Jul 10, 2017 12:36 pm
Location: Hof Germany

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by HarryGeier »

Kunda1 wrote: Wed Oct 24, 2018 5:18 pm This is not an intuitive name. IMHO this page should redirect to an intuitive name. Anybody else agree?
currently:
Sketcher_ConstrainRadius

proposals
Sketcher_ConstrainCircularSize
Sketcher_ConstrainDiameter
Sketcher_ConstrainDiameterOrRadius

not sure if it should cover one or both ways of doing it....
I peronally would have mad ONE page..for both...
Kaum macht man´s richtig , gehts´s
My Video Tutorials on Youtube: https://www.youtube.com/channel/UCoe3B ... p8Q/videos
My FreeCAD Stuff on Hidrive: https://my.hidrive.com/share/qr3l1yddy6#$/
User avatar
NormandC
Veteran
Posts: 18587
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by NormandC »

Kunda1 wrote: Wed Oct 24, 2018 5:18 pm This is not an intuitive name. IMHO this page should redirect to an intuitive name. Anybody else agree?
No. This would break translations.

In any case, these pages are created only because currently, icons below an icon menu cannot be accessed directly with the Std WhatsThis tool. If this could get fixed, then these Comp pages would no longer be required.
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by Kunda1 »

NormandC wrote: Tue Oct 30, 2018 4:36 am In any case, these pages are created only because currently, icons below an icon menu cannot be accessed directly with the Std WhatsThis tool. If this could get fixed, then these Comp pages would no longer be required.
Shall I open a ticket?

Edit: I just read Normand's response in another thread that redirects break translation pages. How does mediawiki then do it? I'm sure the need to shuffle things around comes up for them...
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
User avatar
NormandC
Veteran
Posts: 18587
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by NormandC »

Yes, a ticket would be useful, thanks.

Maybe "break" is a strong word, but it complicates things a lot. I'm sorry, it's no fault of you guys, but I am just so thoroughly fed up of talking about this (meanwhile I am not contributing to the wiki).

Maybe you should try it by yourself with a few pages, but please, do experiment the translation system on your own even if you have to pick some obscure language and paste lorem ipsum filler to do it. And also please, test the What's This? functionality.

Kunda1 wrote: Tue Oct 30, 2018 10:04 am How does mediawiki then do it?
Do you mean Wikipedia? AFAIK they don't even use the translation plugin. They must be doing their translations manually (ugh). Which means that there is absolutely no way to make sure that the content is the same between languages. In fact, languages have completely separate and different content, most of the time. We decided long ago that we did not want an asymmetric wiki for FreeCAD. We cannot have somebody create a page with original content in a language (say Chinese) that nobody else understands. Original content absolutely needs to be written in English first because that's the common language. Then we need to make it easy for people to translate the content into their own language; and preferably we prevent them from straying from the original. The translation plugin helps in that regard because it breaks down a page into small translation units (basically paragraphs become translation units). But, it is not foolproof: there is an issue with many German pages where a contributor decided last Spring to write completely different content from English. And there seem to be nobody willing or available to fix the issue.

And here I didn't want to spend any more time writing about this yet again, yet I did.
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by Kunda1 »

Mediawiki, not as in Wikipedia, but as the wiki engine that runs many wikis.
Normand, thanks for your response. This is a tedious topic. It's hard to work with this wiki 'inertia'. I feel like we're compromising left and right and doing double work where we shouldn't really need to. I don't think it's laziness that doesn't get the docs and translations where they need to be... it's the software that we're using, IMHO. I also don't want to diminish the work anyone has done or waste your time on this topic.
It's a motivation killer wading through this inertia.
Alone you go faster. Together we go farther
Please mark thread [Solved]
Want to contribute back to FC? Checkout:
'good first issues' | Open TODOs and FIXMEs | How to Help FreeCAD | How to report Bugs
User avatar
NormandC
Veteran
Posts: 18587
Joined: Sat Feb 06, 2010 9:52 pm
Location: Québec, Canada

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by NormandC »

Kunda1 wrote: Wed Oct 31, 2018 3:22 am It's a motivation killer wading through this inertia.
That's certainly right. What I feel most is weariness. I'm tired of seeing people come and go and not stick around, where the wiki is concerned.
User avatar
fosselius
Posts: 381
Joined: Sat Apr 23, 2016 10:03 am
Contact:

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by fosselius »

How about using animated GIF instead of static pictures for the different tool pages, its very helpful for new users.
here is two examples:
centerCircle2.gif
centerCircle2.gif (329.93 KiB) Viewed 1242 times
3pointRim2.gif
3pointRim2.gif (597.76 KiB) Viewed 1242 times
I do not know how much/little to show of the GUI, but it should be clear that you have the sketcher activated and where to find the button.
It might also be good to always start from origo to give a clear frame of reference for all actions.

I know from experience that the most "simple" and "obvious" things can cause hours of frustration for the end user.
When i begun using Blender and then later FreeCAD i spent most of my time trying to figure out how move/zoom/rotation/selection etc worked because the instructors/videos never mentioned it because it was "obvious". We all do a lot of magic keystrokes/clicks without noting it, because it have become a habit to us.

created with peek and key-mon in ubuntu
chrisb
Veteran
Posts: 53930
Joined: Tue Mar 17, 2015 9:14 am

Re: 0003054: Sketcher - List of important but empty wiki pages that need contents

Post by chrisb »

We have discussed that before and voted against it.
A Sketcher Lecture with in-depth information is available in English, auf Deutsch, en français, en español.
Post Reply