Redesigning the configuration pages

@ms - Concerning the recent changes to: https://wiki.ipfire.org/configuration

Dude! Too much! All of the stuff that helps newbies is gone.

I agree some pages are too busy and the https://wiki.ipfire.org/configuration (The Web Interface) is too busy but now it is too minimal.

You’ve made the page perfect for the experts but not helpful for the newbies.

On a scale of 1 to 10

  • a Newbie is a “1” and
  • an Expert is a “10”
  • I am near a “3” (if that!)
  • and you are closer to a “12+”

So when I add pages I am writing for something closer to my level. And I am more a “visual” type person. That why I add lots of images.

I’d be happy to tighten things up.

There are so much more degrees into the scale from n00b to expert. The more you know, the more you understand how much you don’t know.

1 Like

What was that?

Please read the guidelines then. The images that have been on the page were not helpful. They showed a dropdown menu. We all know what that looks like, but it was not clear where it was. The menus also change from installation to installation depending on configuration and installed add-ons.

Now there is one big image that shows the whole of the web UI. We didn’t even had that before. This should give people a clearer image on where they should be.

There are steps on the page on how to get to the web UI (on a sub-page actually) and people will now have to click through the right section to find what they are looking for.

The page resembles the hierarchy of the web UI and that is easily accessible. There are N links, one for each menu item on the web UI.

I have no idea why some add-ons or pages where “featured” on the page before. I suppose the author thought that their add-on is the most important one - that happens to all of us actually.

I do not think that this page is now more expert level.

The images.

For experts the images are not helpful. For newbies they are helpful. And they were very helpful for me as a newbie.

I’m not sure I understand this part. I don’t remember add-on (or the items featured) on the wiki.ipfire.org - Web Interface (WebGUI) wiki page, but I’ll look again.

https://wiki.ipfire.org/configuration?revision=2019-10-23T08:43:36.000745

Samba & mpfire were linked here

1 Like

I 2nd the notion of visual type person.

I went to this link, my first impressions were, where are the images? I could not visualize it. When I went to the IPFire system and looked, then read the above page, it made more sense. So including a picture would help me.

So rating any documentation on any product:
F - nothing (most products fall here)
D - Summary, a few instructions/notes/references here and there, missing alot of details.
C - Straight text, no images/pictures. Details, but can not tell if complete.
B - images/pictures with text, details or links to details, Not intuitive flow of information (a lot of digging to find information), but complete information.
A - Intuitive flow of information, images/pictures with text, details or links to details, complete information.

1 Like

There is a picture now.

As a previous user of IPFire returning to IPFire after about 5 years, I generally like the structure of the wiki, with https://wiki.ipfire.org/configuration being easy to use, to find a specific topic.

There is certainly room for improvement on specific pages … if I can, I will try to help out.

5 Likes

Hi Henrik, welcome back!
I don’t think, editing the wiki is a “help out”. Each registered user of people.ipfire.org is allowed to edit the wiki.
This means, just ‘apply-only’ users should do this in case of incompleteness. Developpers tend to see much as sufficient, because they know the internals and the documentation of the packages.
Be sure, that your modifications are revised by some devs. So no false information finds its way into the wiki.

As @jon has pointed out, there is a number of pages with “FIXME” sections, as well pages with hilariously outdated information, like https://wiki.ipfire.org/configuration/network/proxy/example_conf.

sarcasm on Of course, I specifically came here to mess up the wiki sarcasm off

1 Like

If you work some magic on the proxy Wiki that would be great!
:mage:

Especially the WPAD / PAC page.

I got lost and never got a convention proxy setup working.