Duplicate pages in TechDraw

Discussions about the wiki documentation of FreeCAD and its translation.
Post Reply
renatorivo
Posts: 2439
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Duplicate pages in TechDraw

Post by renatorivo » Sun Mar 22, 2020 8:53 pm

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
Posts: 3956
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx » Sun Mar 22, 2020 10:07 pm

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.
To support the documentation effort, and code development, your donation is appreciated: paypal.
User avatar
uwestoehr
Posts: 1425
Joined: Sun Jan 27, 2019 3:21 am

Re: Duplicate pages in TechDraw

Post by uwestoehr » Mon Mar 23, 2020 11:15 pm

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
Posts: 3956
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx » Mon Mar 23, 2020 11:34 pm

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.
To support the documentation effort, and code development, your donation is appreciated: paypal.
User avatar
uwestoehr
Posts: 1425
Joined: Sun Jan 27, 2019 3:21 am

Re: Duplicate pages in TechDraw

Post by uwestoehr » Mon Mar 23, 2020 11:46 pm

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
Posts: 2439
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: Duplicate pages in TechDraw

Post by renatorivo » Tue Mar 24, 2020 7:41 am

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
Posts: 1425
Joined: Sun Jan 27, 2019 3:21 am

Re: Duplicate pages in TechDraw

Post by uwestoehr » Tue Mar 24, 2020 11:36 am

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
Posts: 2439
Joined: Tue Feb 21, 2012 8:07 pm
Location: Torino - Italy

Re: Duplicate pages in TechDraw

Post by renatorivo » Tue Mar 24, 2020 8:41 pm

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
Posts: 3956
Joined: Thu Oct 18, 2018 9:18 pm

Re: Duplicate pages in TechDraw

Post by vocx » Tue Mar 24, 2020 11:25 pm

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.
To support the documentation effort, and code development, your donation is appreciated: paypal.
Post Reply

Who is online

Users browsing this forum: No registered users and 1 guest