Wiki usability.

Discussions about the wiki documentation of FreeCAD and its translation.
Post Reply
User avatar
onekk
Veteran
Posts: 5603
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Wiki usability.

Post by onekk »

I have some difficulties to find as there is no a proper Wiki index.

A link to an index should be present in the Wiki "Left Side Bar" at top prior to Overview, this will ease for sure searching informations.

And putting here: viewtopic.php?t=2264 under "Useful Links" a link to an Index Wiki Page will help a lot even new comers.

What do you think?

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.
User avatar
Roy_043
Veteran
Posts: 7358
Joined: Thu Dec 27, 2018 12:28 pm

Re: Wiki usability.

Post by Roy_043 »

I am confused. You say there is no index and then want a link to that index.
heda
Veteran
Posts: 1266
Joined: Sat Dec 12, 2015 5:49 pm

Re: Wiki usability.

Post by heda »

a bit of a hack, but the easiest way i have found to get a somewhat complete list of pages on wiki is:
https://wiki.freecad.org/Special:LanguageStats
maybe there is a better way...

or if one wants to randomly explore the wiki, this is a good start...
https://wiki.freecad.org/Special:Categories
User avatar
onekk
Veteran
Posts: 5603
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Wiki usability.

Post by onekk »

Roy_043 wrote: Sun Sep 17, 2023 12:50 pm I am confused. You say there is no index and then want a link to that index.
Sorry for having made a mess.

- An index page would be a big improvement
- Having the link to this index page on top of the "left side bar" seems the most appropriate place to always have in a comfortable place a way to start from scratch.

Hoping to have explained better. :oops: (But I don't guarantee :lol: )

To extend a little the concept actual content of the "left side bar" could be placed in the index page, maybe with a link to an Alphabetical or other organized indexes.

Most manuals have a top bar with:

- prior
- index
- next

Line to permit a navigation, this could be a way to increase the real estate of a wiki page and have the index "one click away".

But this is as usual a personal idea.


Kind Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.
User avatar
Roy_043
Veteran
Posts: 7358
Joined: Thu Dec 27, 2018 12:28 pm

Re: Wiki usability.

Post by Roy_043 »

Please first have a good look at the current Wiki:
https://wiki.freecad.org/
https://wiki.freecad.org/Online_Help_Toc
https://wiki.freecad.org/Online_Help_Startpage
etc.

There used to be a clickable FreeCAD icon in the left bar, which is no longer displayed.
User avatar
onekk
Veteran
Posts: 5603
Joined: Sat Jan 17, 2015 7:48 am
Contact:

Re: Wiki usability.

Post by onekk »

Roy_043 wrote: Sun Sep 17, 2023 4:33 pm ...

There used to be a clickable FreeCAD icon in the left bar, which is no longer displayed.
Thanks, for participating.

if the left panel would have https://wiki.freecad.org/Online_Help_Toc at top named TOC or Index, it will be nearly what I have in mind.

With some more sub-pages it will be more easy to districate between the Wiki, as the "very long left sidebar" is not very readable (but probably it is my fault, as I'm quite old and in the phase when monitor is too far and paper is too near to use a single pair of lenses :lol: ).

Regards

Carlo D.
GitHub page: https://github.com/onekk/freecad-doc.
- In deep articles on FreeCAD.
- Learning how to model with scripting.
- Various other stuffs.
User avatar
Roy_043
Veteran
Posts: 7358
Joined: Thu Dec 27, 2018 12:28 pm

Re: Wiki usability.

Post by Roy_043 »

OK, I have added "Index" to the left bar. Note that the text "FreeCAD Documentation" is the current link to the main page (replacing the icon).

Translators can find translation instructions here:
https://forum.freecadweb.org/viewtopic. ... 27#p619727

Pages in this case are:
MediaWiki:Sidebar-index
MediaWiki:Sidebar-index-target
Post Reply