Duplicate pages in TechDraw

Discussions about the wiki documentation of FreeCAD and its translation.
Forum rules
Be nice to others! Respect the FreeCAD code of conduct!
renatorivo
Veteran
Posts: 2611
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Duplicate pages in TechDraw

Post by renatorivo »

There are several duplicate pages in the TechDraw documentation. I think old pages can be deleted.
These are the ones I found:
Old -> New

https://wiki.freecadweb.org/TechDraw_New_Default -> https://wiki.freecadweb.org/TechDraw_PageDefault
https://wiki.freecadweb.org/TechDraw_New_Pick -> https://wiki.freecadweb.org/TechDraw_PageTemplate
https://wiki.freecadweb.org/TechDraw_NewProjGroup -> https://wiki.freecadweb.org/TechDraw_ProjectionGroup
https://wiki.freecadweb.org/TechDraw_NewAnnotation -> https://wiki.freecadweb.org/TechDraw_Annotation
https://wiki.freecadweb.org/TechDraw_Redraw -> https://wiki.freecadweb.org/TechDraw_RedrawPage
https://wiki.freecadweb.org/TechDraw_SaveDXF -> https://wiki.freecadweb.org/TechDraw_ExportPageDXF
https://wiki.freecadweb.org/TechDraw_SaveSVG -> https://wiki.freecadweb.org/TechDraw_ExportPageSVG
https://wiki.freecadweb.org/TechDraw_GeomHatch -> https://wiki.freecadweb.org/TechDraw_GeometricHatch
https://wiki.freecadweb.org/TechDraw_Spreadsheet -> https://wiki.freecadweb.org/TechDraw_SpreadsheetView
https://wiki.freecadweb.org/TechDraw_NewDetail -> https://wiki.freecadweb.org/TechDraw_DetailView
https://wiki.freecadweb.org/TechDraw_NewArch -> https://wiki.freecadweb.org/TechDraw_ArchView
https://wiki.freecadweb.org/TechDraw_NewDetail -> https://wiki.freecadweb.org/TechDraw_DetailView
https://wiki.freecadweb.org/TechDraw_NewDraft -> https://wiki.freecadweb.org/TechDraw_DraftView
https://wiki.freecadweb.org/TechDraw_NewSection -> https://wiki.freecadweb.org/TechDraw_SectionView
https://wiki.freecadweb.org/TechDraw_Toggle -> https://wiki.freecadweb.org/TechDraw_ToggleFrame

Please check if I have made mistakes, or if there are others.
Do you agree to delete old pages?
EDIT: And to put a link to the new ones?
Last edited by renatorivo on Mon Mar 23, 2020 8:50 pm, edited 1 time in total.
vocx
Veteran
Posts: 5197
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx »

renatorivo wrote: Sun Mar 22, 2020 8:53 pm ...
Do you agree to delete old pages?
Please ask uwestoehr. He's the one who created the new pages. He didn't want to just rename the pages, because he says that older versions of FreeCAD, that is, 0.18 and earlier will not find their documentation. But that will not happen because that version is already released, and that documentation is already generated.

My opinion is we can delete the old pages and be turned redirections to the new pages so that the links in this forum and the wiki itself don't break.
Always add the important information to your posts if you need help. Also see Tutorials and Video tutorials.
To support the documentation effort, and code development, your donation is appreciated: liberapay.com/FreeCAD.
User avatar
uwestoehr
Veteran
Posts: 4961
Joined: Sun Jan 27, 2019 3:21 am
Location: Germany
Contact:

Re: Duplicate pages in TechDraw

Post by uwestoehr »

vocx wrote: Sun Mar 22, 2020 10:07 pm My opinion is we can delete the old pages and be turned redirections to the new pages so that the links in this forum and the wiki itself don't break.
OK, but can we please wait until FC 0.19 is released?
I mean in TechDraw things have changed dramatically. Users of FC 0.18 don't help the new pages much since most properties, menus etc. were changed, reordered, deleted etc.
vocx
Veteran
Posts: 5197
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx »

uwestoehr wrote: Mon Mar 23, 2020 11:15 pm OK, but can we please wait until FC 0.19 is released?
...
Of course. I mean, you changed radically the software, so you should have thought about how to best handle the documentation as well. Changing a lot of stuff shouldn't be done so abruptly, is my suggestion.
Always add the important information to your posts if you need help. Also see Tutorials and Video tutorials.
To support the documentation effort, and code development, your donation is appreciated: liberapay.com/FreeCAD.
User avatar
uwestoehr
Veteran
Posts: 4961
Joined: Sun Jan 27, 2019 3:21 am
Location: Germany
Contact:

Re: Duplicate pages in TechDraw

Post by uwestoehr »

vocx wrote: Mon Mar 23, 2020 11:34 pm Changing a lot of stuff shouldn't be done so abruptly, is my suggestion.
A new major version is there to introduce new things and Wandererfan did most of the work. All the beautiful new features are from him. I only uniformed the things, fixed bugs polished the UI etc. While writing the new Wiki pages I found tons of bugs and most of them are now fixed, so it was worth it.
renatorivo
Veteran
Posts: 2611
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: Duplicate pages in TechDraw

Post by renatorivo »

uwestoehr wrote: Mon Mar 23, 2020 11:15 pm OK, but can we please wait until FC 0.19 is released?
In https://wiki.freecadweb.org/TechDraw_New_Pick I added an alert. Can we add it to all the old pages?
Since many users will still be using FC0.18 for a long time, with this warning, or something similar, we can keep them.
User avatar
uwestoehr
Veteran
Posts: 4961
Joined: Sun Jan 27, 2019 3:21 am
Location: Germany
Contact:

Re: Duplicate pages in TechDraw

Post by uwestoehr »

renatorivo wrote: Tue Mar 24, 2020 7:41 am In https://wiki.freecadweb.org/TechDraw_New_Pick I added an alert. Can we add it to all the old pages?
Since many users will still be using FC0.18 for a long time, with this warning, or something similar, we can keep them.
I am fine with this. However, I still want to wait with these action until we have a 0.19 version ready that is not changing anymore. At the moment we are still fixing bugs leading to changed names, reordered objects in dialogs etc. Therefore FC 0.19 should be stable because only then the new Wiki pages will be stable too. (You might have seen that I am still changing them a lot).

Since I am involved in the development, am I allowed to make this decision and when I think it is stable enough, add the alert?
renatorivo
Veteran
Posts: 2611
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: Duplicate pages in TechDraw

Post by renatorivo »

uwestoehr wrote: Tue Mar 24, 2020 11:36 am Since I am involved in the development, am I allowed to make this decision and when I think it is stable enough, add the alert?
It's ok for me
vocx
Veteran
Posts: 5197
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx »

uwestoehr wrote: Tue Mar 24, 2020 11:36 am ...
Since I am involved in the development, am I allowed to make this decision and when I think it is stable enough, add the alert?
This is the ideal world, that the developer both develops and documents the work. Usually we have the opposite problem that the developer doesn't provide enough documentation, and so documentation pages become obsolete.

I, however, prefer to add documentation on the new version as soon as that feature is available, even before, because in that case I don't forget adding it later. It's up to you. I would add renato's message already.
Always add the important information to your posts if you need help. Also see Tutorials and Video tutorials.
To support the documentation effort, and code development, your donation is appreciated: liberapay.com/FreeCAD.
david69
Veteran
Posts: 1773
Joined: Wed Jan 01, 2014 7:48 pm

Re: Duplicate pages in TechDraw

Post by david69 »

coming from this thread: https://forum.freecadweb.org/viewtopic.php?f=21&t=49699

i've added the version 0.19 to all new pages that Renatorivo has captured.

there is one which is not created yet and called TechDraw NewView and refered on many Techdraw pages like for ex here: TechDraw_Toggle.

is it still plan to write if or not?
Post Reply