Page 3 of 4
Re: Wiki:Discussion usage
Posted: Thu Jun 16, 2022 6:38 pm
by manos
onekk wrote: ↑Thu Jun 16, 2022 1:20 pm
manos wrote: ↑Thu Jun 16, 2022 12:53 pm
... There are plenty of pages with ambiguous terms.
Yes I agree, but see the following:
manos wrote: ↑Thu Jun 16, 2022 12:53 pm
What is Part ? The Workbench , an object or the container created with Std Part ?
This is more about a "disambiguation page" like in wikipedia, or maybe on some "Modelling guide" or even in an "Introductory Page"
I am afraid that speaking about ambiguity it is me who writes the most ambiguous texts: When I refer to unclear words I do not mean that their meanings are unknown. I mean that their meaning at that particular line in this Wiki:page is unclear-ambiguous. In other words when the user reads Part it is not clear if he means the Workbench Part or an object created by Part Workbench or the Std Part command which creates the container of bodies.
manos wrote: ↑Thu Jun 16, 2022 12:53 pm
The origin is referred to that of the body , or the Global origin etc,etc ? E.g. Placement and Attachment commands are full of indefinite terms.
A note would help to determine the reference of the Origin .etc etc.
This is a constructive post, and I hope with some argumented answers, if this could seems offensive or polemic, sorry it was not my intention.
Not polemic at all. Thanks for the contribution.
Re: Wiki:Discussion usage
Posted: Thu Jun 16, 2022 6:53 pm
by onekk
I admit that Part is not the best choice, but not for Part WB that is the core of FC.
Other objects are ambigius and even Part Design is not the hest choice.
But the problem is to remain on topic is that:
1) better documentation is needed but is improving.
2) adding notes as a tab is not clever way as it is add complexity even in the optics of maintainability.
3) discuting about a way of improving documentation is not a sin.
Some things are moving as in latest times something is moving.
Wait sometime and probably you will see some improvement, from what I know from other discussion on some threads.
If you want to collaborate it will be a good thing to signal where things are ambiguous and maybe open a discussion about this topic on the documentation thread (now I'm on mobile so no link sorry)
Regards.
Carlo D.
Re: Wiki:Discussion usage
Posted: Thu Jun 16, 2022 7:08 pm
by manos
adrianinsaval wrote: ↑Thu Jun 16, 2022 1:52 pm
manos wrote: ↑Thu Jun 16, 2022 12:53 pm
Also this tab will help maintainers locate points of possible corrections and additions to the main page text.
I think the idea of a "Notes" tab to every page, it is a step to a more "decent documentation" and it is worthy of consideration.
It is better and more maintainable to add a Notes section in the wiki as it's done in many pages already, and some actually link to forum discussions when appropriate.
Where are the Notes section ,can you give an example ?
The see also section is also useful if you want to clarify stuff and normally when Part and other ambiguous terms are mentioned it is specified and linked to the corresponding page were it's explained, and even the icon is displayed.
[/quote]
What about "also section" . An example ?
Thanks for infos and ideas adraninsaval.
Re: Wiki:Discussion usage
Posted: Thu Jun 16, 2022 7:18 pm
by Roy_043
@manos Your suggestion is not practical. We simply can't do this. We do not have the human resources to monitor this. And there is also the proposed transition of the documentation to GitHub which is another reason to not do this.
Re: Wiki:Discussion usage
Posted: Thu Jun 16, 2022 9:49 pm
by manos
Roy_043 wrote: ↑Thu Jun 16, 2022 7:18 pm
@manos ...We do not have the human resources to monitor this...
My idea does not comprise any monitoring. In contrary "Notes" mainly will be the conclusions from (monitored) forum.
Roy_043 wrote: ↑Thu Jun 16, 2022 7:18 pm
And there is also the proposed transition of the documentation to GitHub ....
A rather nightmare idea: Make the simple: Wiki complicated: Github
Re: Wiki:Discussion usage
Posted: Fri Jun 17, 2022 8:49 am
by FBXL5
Roy_043 wrote: ↑Thu Jun 16, 2022 7:18 pm
And there is also the proposed transition of the documentation to GitHub...
I had a look at the GitHub wiki and so far it's not my cup of tea. It does neither invite to use nor to edit.
Re: Wiki:Discussion usage
Posted: Fri Jun 17, 2022 10:58 am
by onekk
FBXL5 wrote: ↑Fri Jun 17, 2022 8:49 am
I had a look at the GitHub wiki and so far it's not my cup of tea. It does neither invite to use nor to edit.
Sadly GitHub is the way most program are developed in a multiuser scenario.
If the goal is to maintain things, in decentralized way and to merge different modification from different people in the same file, this is the "only viable solution" to use.
It is not very user friendly at a first glance, but has enormous advantages once learned to use it, on of the many it maintain history of changes, so it is very easy to revert to e prior state if someone has done a mess.
Roy_043 wrote: ↑Thu Jun 16, 2022 7:18 pm
And there is also the proposed transition of the documentation to GitHub...
Proposed?
There is not already a GitHub repo?
Regards
Carlo D.
Re: Wiki:Discussion usage
Posted: Fri Jun 17, 2022 2:09 pm
by FBXL5
onekk wrote: ↑Fri Jun 17, 2022 10:58 am
Sadly GitHub is the way most program are developed in a multiuser scenario.
If the goal is to maintain things, in decentralized way and to merge different modification from different people in the same file, this is the "only viable solution" to use.
It is not very user friendly at a first glance, but has enormous advantages once learned to use it, on of the many it maintain history of changes, so it is very easy to revert to e prior state if someone has done a mess.
I guess it is useful for coding, scripting, and macro editing tasks, but not for seeking information. Maybe the yet available pages are in a kind of prototype state, then I may reconsider my opinion when they are finished.
I always thought that the wiki is for the user looking for help or explanation. And I don't want a help system that I have to learn/study prior to use for advantages that I probably never need. The wiki has a history, too. So, that is no advantage for GitHub in may opinion.
Re: Wiki:Discussion usage
Posted: Fri Jun 17, 2022 2:17 pm
by onekk
I guess the intention is to maintain wiki pages using GitHub, not consulting them in GitHub.
Also it is a proposal, and I see that it coulb be very handy as not everyone live in a country with mega internet speed and unlimited bandwidth that is needed to edit a page (or translate it) with a "web interface".
So having a way to download once the big bunch if data and updating only diffs will be a good solution for many
Regards.
Carlo D.
Re: Wiki:Discussion usage
Posted: Fri Jun 17, 2022 2:24 pm
by Roy_043
As I understand it the GitHub documentation will replace the Wiki.