Coordinating Documentation and Translations before v0.20 release

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: Coordinating Documentation and Translations before v0.20 release

Post by Kunda1 »

Probably last thing before we make the official release. There is a windows libpack packaging/3rd-party dependency issue that is blocking release ATM.
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
uwestoehr
Veteran
Posts: 4961
Joined: Sun Jan 27, 2019 3:21 am
Location: Germany
Contact:

Re: Coordinating Documentation and Translations before v0.20 release

Post by uwestoehr »

kaktus wrote: Sun May 15, 2022 11:07 am When is this supposed to happen?
The release should definitely happen this month. Here is a first test release: https://forum.freecadweb.org/viewtopic.php?f=9&t=68705
(your todays' changes are not included in this)
User avatar
Kunda1
Veteran
Posts: 13434
Joined: Thu Jan 05, 2017 9:03 pm

Re: Coordinating Documentation and Translations before v0.20 release

Post by Kunda1 »

@uwestoehr can we ask the devs, testers, and power-users to move their attention to documentation and solving open translations issues?
If each dev could help make a list of open/pending documentation needs (for their respective workbenches) since not all features or 'known issues' for certain functions/tools get updated in the wiki even though they've been fixed or modified. In other words, Sketcher folks can divy up the Sketcher workbench wiki pages, check for accuracy, make a list and help orient documentation writers (or they could do it themselves) what needs modifying.

Also, continuing with the Sketcher workbench as an example, if a dev could log in to the crowdin and look at all the open issues that translators have flagged for Sketcher related translations.
Crowdin UI showing an 'Unresolved' issue.
Crowdin UI showing an 'Unresolved' issue.
Screenshot_20220515_133340.png (225.45 KiB) Viewed 3673 times
Log in to crowdin via https://crowdin.com/project/freecad
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
kaktus
Veteran
Posts: 1174
Joined: Sun Aug 11, 2019 11:59 am
Location: opolskie
Contact:

Re: Coordinating Documentation and Translations before v0.20 release

Post by kaktus »

Regarding the workbench sketcher and the Crowdin environment
there is one unsolved issue:

https://github.com/FreeCAD/FreeCAD-tran ... 1120170593
Twórca polskiej wersji Wiki dla FreeCAD, współwórca polskiej wersji GUI.
"Cierpliwym być musisz, by wiedzę zgłębiać tajemną, gdyż ciemna strona mocy niszczącą i silną jest".
User avatar
uwestoehr
Veteran
Posts: 4961
Joined: Sun Jan 27, 2019 3:21 am
Location: Germany
Contact:

Re: Coordinating Documentation and Translations before v0.20 release

Post by uwestoehr »

Kunda1 wrote: Sun May 15, 2022 5:39 pm @uwestoehr can we ask the devs, testers, and power-users to move their attention to documentation and solving open translations issues?
Sure. Just post in this thread: https://forum.freecadweb.org/viewtopic.php?f=10&t=66407

If there are issues they should be reported to our main issue tracker. This way they will be fixed quickly.
pmlee
Posts: 46
Joined: Sun Jun 10, 2018 3:49 pm
Location: Taiwan

Re: Coordinating Documentation and Translations before v0.20 release

Post by pmlee »

Kunda1 wrote: Sun May 15, 2022 5:39 pm @uwestoehr can we ask the devs, testers, and power-users to move their attention to documentation and solving open translations issues?
If each dev could help make a list of open/pending documentation needs (for their respective workbenches) since not all features or 'known issues' for certain functions/tools get updated in the wiki even though they've been fixed or modified. In other words, Sketcher folks can divy up the Sketcher workbench wiki pages, check for accuracy, make a list and help orient documentation writers (or they could do it themselves) what needs modifying.

Also, continuing with the Sketcher workbench as an example, if a dev could log in to the crowdin and look at all the open issues that translators have flagged for Sketcher related translations.

Screenshot_20220515_133340.png

Log in to crowdin via https://crowdin.com/project/freecad
This is a good suggestion. Actually, I've modified some old translations which I think are Inappropriate. I'll leave comments in the open issue as a remark.
david69
Veteran
Posts: 1773
Joined: Wed Jan 01, 2014 7:48 pm

Re: Coordinating Documentation and Translations before v0.20 release

Post by david69 »

checking the GUI, notice we don't find the original text for:
- Inspection wb
- Surface wb

note also: https://forum.freecadweb.org/viewtopic.php?f=18&t=68729

I can not find neither the original text corresponding to
Capture du 2022-05-16 10-54-53.png
Capture du 2022-05-16 10-54-53.png (67.37 KiB) Viewed 3245 times
they need fixes
User avatar
M4x
Veteran
Posts: 1472
Joined: Sat Mar 11, 2017 9:23 am
Location: Germany

Re: Coordinating Documentation and Translations before v0.20 release

Post by M4x »

Regarding the wiki: Is this page up-to-date (enough)? https://wiki.freecad.org/index.php?titl ... nishedDocu
User avatar
Roy_043
Veteran
Posts: 8450
Joined: Thu Dec 27, 2018 12:28 pm

Re: Coordinating Documentation and Translations before v0.20 release

Post by Roy_043 »

M4x wrote: Sun May 29, 2022 9:23 am Regarding the wiki: Is this page up-to-date (enough)? https://wiki.freecad.org/index.php?titl ... nishedDocu
Probably not. There are pages in that list that I would consider finished and, on the other hand, unfinished pages that are not included. Also keep in mind that a 'finished' page can be out of date.
User avatar
M4x
Veteran
Posts: 1472
Joined: Sat Mar 11, 2017 9:23 am
Location: Germany

Re: Coordinating Documentation and Translations before v0.20 release

Post by M4x »

Therefore I shouldn't use this as an orientation and check look through the workbenches "I know" instead?
Post Reply