Message ID | 20200515213952.15127-1-ipfr@tfitzgeorge.me.uk |
---|---|
Headers |
Return-Path: <development-bounces@lists.ipfire.org> Received: from mail01.ipfire.org (mail01.haj.ipfire.org [172.28.1.202]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384) server-digest SHA384 client-signature ECDSA (P-384) client-digest SHA384) (Client CN "mail01.haj.ipfire.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by web04.haj.ipfire.org (Postfix) with ESMTPS id 49P1zZ0wjrz3xVh for <patchwork@web04.haj.ipfire.org>; Fri, 15 May 2020 21:40:25 +0000 (UTC) Received: from mail02.haj.ipfire.org (mail02.haj.ipfire.org [172.28.1.201]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384) client-signature ECDSA (P-384)) (Client CN "mail02.haj.ipfire.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mail01.ipfire.org (Postfix) with ESMTPS id 49P1zX1BR8z1Kg; Fri, 15 May 2020 21:40:24 +0000 (UTC) Received: from mail02.haj.ipfire.org (localhost [127.0.0.1]) by mail02.haj.ipfire.org (Postfix) with ESMTP id 49P1zW47tpz2yBT; Fri, 15 May 2020 21:40:23 +0000 (UTC) Received: from mail01.ipfire.org (mail01.haj.ipfire.org [172.28.1.202]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384) client-signature ECDSA (P-384)) (Client CN "mail01.haj.ipfire.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mail02.haj.ipfire.org (Postfix) with ESMTPS id 49P1zT5sXdz2y9P for <development@lists.ipfire.org>; Fri, 15 May 2020 21:40:21 +0000 (UTC) Received: from smtp.hosts.co.uk (smtp.hosts.co.uk [85.233.160.19]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-384) server-digest SHA384) (Client did not present a certificate) by mail01.ipfire.org (Postfix) with ESMTPS id 49P1zS0fphz1Ym for <development@lists.ipfire.org>; Fri, 15 May 2020 21:40:19 +0000 (UTC) Received: from [95.149.142.196] (helo=aragorn.hosts.co.uk.tfitzgeorge.me.uk) by smtp.hosts.co.uk with esmtpa (Exim) (envelope-from <ipfr@tfitzgeorge.me.uk>) id 1jZi3r-0005Nq-6o; Fri, 15 May 2020 22:40:13 +0100 From: Tim FitzGeorge <ipfr@tfitzgeorge.me.uk> To: development@lists.ipfire.org Subject: [PATCH 0/3] Help for GUI Date: Fri, 15 May 2020 22:39:49 +0100 Message-Id: <20200515213952.15127-1-ipfr@tfitzgeorge.me.uk> X-Mailer: git-send-email 2.26.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=lists.ipfire.org; s=202003rsa; t=1589578820; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding; bh=6W1cBmn7Z95PmRqnvnyAnCLaIdHJOC4x6r0D5vuOvfY=; b=lEZ9adOpZe4IKRPBvRu3UZmbbl+cbU2EldU968RwH6qEWYvCA7tIzm/E2BDXji3oGoTMx2 QUCmcQ1iOMkvezjdrT+rjtQy7m6CNt4s0d4phb/NuCf0/lgh9RrUSRCX8MVLNRqQlHoT5e EeFcBr7V433A1fyegAUlIwpWE+0y754LG6M2yRbAlLoq0y7Qq7HTy8h/ry5VgMQEwE+O2a yzOeaS91zxshFx5/ezurYf5SD5RJAhLxRs3yG46DIUR0puK2xTYqMtRxOFFUNPogy5YWeT elf77EL4Vs2RE6wU7/d2Ily3zzletRep6vtzx9+6Pj17wuxEpA2iei/k7qJC6A== ARC-Seal: i=1; s=202003rsa; d=lists.ipfire.org; t=1589578820; a=rsa-sha256; cv=none; b=ReKgoOuNgXa9HXRg+CW8jNGSkm7P30YImTVNZVa2r7owoEVW/YxLeq/89DP95QfYHxISlo bX+h+wwbQII9O6m/sDGn+jRwXn1GSCpFibRtzidg2Pwotof7iioW43RORjR4EEnrAVDHZt Gir1E7RCmiyNVbmdQaZfkMmbxiRdwhBmy42PmSj9HmaAiQt7QbWIYsCSw6QyxCGwNye9Y8 QpS9DvrgfGRmTtMZOb+ctCkZKhGmZWM1sOW0d/PUt+yZUosFwtvyiESmN64KnqcCPr8JMo PqcTn2M33I7Nai3gzQ9GPZE3o+okVGbKSr8mmvInDwBqX3xxsUeNJ6flsIMW2g== ARC-Authentication-Results: i=1; mail01.ipfire.org; dkim=none; spf=pass (mail01.ipfire.org: domain of ipfr@tfitzgeorge.me.uk designates 85.233.160.19 as permitted sender) smtp.mailfrom=ipfr@tfitzgeorge.me.uk Authentication-Results: mail01.ipfire.org; dkim=none; dmarc=none; spf=pass (mail01.ipfire.org: domain of ipfr@tfitzgeorge.me.uk designates 85.233.160.19 as permitted sender) smtp.mailfrom=ipfr@tfitzgeorge.me.uk X-Rspamd-Queue-Id: 49P1zS0fphz1Ym X-Spamd-Result: default: False [1.27 / 11.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; TO_DN_SOME(0.00)[]; R_MISSING_CHARSET(2.50)[]; R_SPF_ALLOW(-0.20)[+ip4:85.233.160.0/27]; RWL_MAILSPIKE_GOOD(0.00)[85.233.160.19:from]; ARC_SIGNED(0.00)[i=1]; BROKEN_CONTENT_TYPE(1.50)[]; MX_GOOD(-0.01)[]; RCPT_COUNT_TWO(0.00)[2]; RECEIVED_SPAMHAUS_PBL(0.00)[95.149.142.196:received]; RCVD_TLS_LAST(0.00)[]; R_DKIM_NA(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; BAYES_HAM(-2.28)[96.65%]; ASN(0.00)[asn:8622, ipnet:85.233.160.0/19, country:GB]; ARC_NA(0.00)[]; RCVD_IN_DNSWL_LOW(-0.10)[85.233.160.19:from]; FROM_HAS_DN(0.00)[]; MIME_GOOD(-0.10)[text/plain]; DMARC_NA(0.00)[tfitzgeorge.me.uk]; TO_MATCH_ENVRCPT_SOME(0.00)[]; MID_CONTAINS_FROM(1.00)[]; NEURAL_HAM(-1.05)[-1.045]; IP_REPUTATION_SPAM(0.01)[asn: 8622(0.00), country: GB(0.01), ip: 85.233.160.19(0.00)]; RCVD_COUNT_TWO(0.00)[2] X-Rspamd-Server: mail01.haj.ipfire.org X-BeenThere: development@lists.ipfire.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: IPFire development talk <development.lists.ipfire.org> List-Unsubscribe: <https://lists.ipfire.org/mailman/options/development>, <mailto:development-request@lists.ipfire.org?subject=unsubscribe> List-Archive: <http://lists.ipfire.org/pipermail/development/> List-Post: <mailto:development@lists.ipfire.org> List-Help: <mailto:development-request@lists.ipfire.org?subject=help> List-Subscribe: <https://lists.ipfire.org/mailman/listinfo/development>, <mailto:development-request@lists.ipfire.org?subject=subscribe> Errors-To: development-bounces@lists.ipfire.org Sender: "Development" <development-bounces@lists.ipfire.org> |
Series | Help for GUI | |
Message
Tim FitzGeorge
May 15, 2020, 9:39 p.m. UTC
Add per-page help link to GUI. The link is extracted from the menu file and added to the menu. Currently only implemented for 'ipfire' and 'ipfire-rounded' themes. Tim FitzGeorge (3): Help for GUI - ipfire theme code Help for GUI - Help links Help for GUI - help link style config/menu/10-system.menu | 11 +++++++ config/menu/20-status.menu | 13 ++++++++ config/menu/30-network.menu | 20 +++++++++-- config/menu/40-services.menu | 6 ++++ config/menu/50-firewall.menu | 8 ++++- config/menu/60-ipfire.menu | 1 + config/menu/70-log.menu | 33 ++++++++++++------- config/menu/EX-apcupsd.menu | 1 + config/menu/EX-guardian.menu | 1 + config/menu/EX-mpfire.menu | 1 + config/menu/EX-samba.menu | 1 + config/menu/EX-tor.menu | 1 + config/menu/EX-wlanap.menu | 1 + html/html/themes/ipfire/include/css/style.css | 8 +++++ html/html/themes/ipfire/include/functions.pl | 19 +++++++++-- 15 files changed, 107 insertions(+), 18 deletions(-) -- 2.26.1
Comments
Hi Tim, Thank you very much for submitting these patches. I am afraid that I must say that I oppose these changes. This has recently been discussed on the community portal and although I still have not made my mind up entirely, I think this not helpful to anyone: * We do not have documentation for everything for a start * There is never this “just read one sentence and you suddenly will be an expert” thing this kind of promotes Should we not rather link the wiki somewhere in the footer and encourage people to start reading the whole thing from the start before they do something? What is your rationale to implementing this? Best, -Michael > On 15 May 2020, at 22:39, Tim FitzGeorge <ipfr@tfitzgeorge.me.uk> wrote: > > Add per-page help link to GUI. > The link is extracted from the menu file and added to the menu. > Currently only implemented for 'ipfire' and 'ipfire-rounded' themes. > > Tim FitzGeorge (3): > Help for GUI - ipfire theme code > Help for GUI - Help links > Help for GUI - help link style > > config/menu/10-system.menu | 11 +++++++ > config/menu/20-status.menu | 13 ++++++++ > config/menu/30-network.menu | 20 +++++++++-- > config/menu/40-services.menu | 6 ++++ > config/menu/50-firewall.menu | 8 ++++- > config/menu/60-ipfire.menu | 1 + > config/menu/70-log.menu | 33 ++++++++++++------- > config/menu/EX-apcupsd.menu | 1 + > config/menu/EX-guardian.menu | 1 + > config/menu/EX-mpfire.menu | 1 + > config/menu/EX-samba.menu | 1 + > config/menu/EX-tor.menu | 1 + > config/menu/EX-wlanap.menu | 1 + > html/html/themes/ipfire/include/css/style.css | 8 +++++ > html/html/themes/ipfire/include/functions.pl | 19 +++++++++-- > 15 files changed, 107 insertions(+), 18 deletions(-) > > -- > 2.26.1 >
Hi Michael, On 16/05/2020 10:35, Michael Tremer wrote: > Hi Tim, > > Thank you very much for submitting these patches. > > I am afraid that I must say that I oppose these changes. > > This has recently been discussed on the community portal and although I still have not made my mind up entirely, I think this not helpful to anyone: > > * We do not have documentation for everything for a start Actually, it's not too bad. The only menu items (out of 72) in the core that I couldn't find help for are: Status / VPN: Net-to-Net Statistics Firewall / Firewall Groups Firewall / Blue Access Firewall / OpenVPN Roadwarrior connections log Status / Qos Graphs * Status / Modem Status Status / Atm-status Network / Network configuration * Firewall / UPnP IPFire / Help * Log / Open VPN Log * and at least four of those (*) don't appear to exist. There might well be pages for some of these which I didn't see when I was adding the links. There are also four pages which obviously require further work: Status / Entropy Status / Connections Status / MDstat Network / URL Filter > * There is never this “just read one sentence and you suddenly will be an expert” thing this kind of promotes > True. But in the extreme this could be argued to say that IPFire shouldn't provide any information in the wiki unless it's much more detailed than the current wiki. Where do you draw the line? > Should we not rather link the wiki somewhere in the footer and encourage people to start reading the whole thing from the start before they do something? I think the best place for this is either on the download page or in the installer, so they get prompted to read the wiki before they start playing. I suspect putting a link in the footer wouldn't help many people. If they can't find the wiki on the website they're probably not going to find it in the GUI footer. > > What is your rationale to implementing this? I was following the discussion in the community, and several people seemed to be in favour of the idea. And to quote 'This suggestion has been made plenty of times. I would be happy to accept patches, but so far nobody wanted to work on it.' So I submitted the patches. I understand that there are two sides to the argument. Having the wiki pages linked as help will be beneficial to some people and will just get other people into a mess quicker when they try to do something they don't understand - but having a link to the wiki page may help some of this latter group to realise that they don't understand and need to learn more. Which is going to be of most benefit to most people? I think for me, having the help links would be preferable, but that's for me, with my skill set and personality. Tim > > Best, > -Michael >
Hi, > On 18 May 2020, at 21:18, Tim FitzGeorge <ipfr@tfitzgeorge.me.uk> wrote: > > Hi Michael, > > On 16/05/2020 10:35, Michael Tremer wrote: >> Hi Tim, >> >> Thank you very much for submitting these patches. >> >> I am afraid that I must say that I oppose these changes. >> >> This has recently been discussed on the community portal and although > I still have not made my mind up entirely, I think this not helpful to > anyone: >> >> * We do not have documentation for everything for a start > > Actually, it's not too bad. The only menu items (out of 72) in the core > that I couldn't find help for are: > > Status / VPN: Net-to-Net Statistics > Firewall / Firewall Groups > Firewall / Blue Access > Firewall / OpenVPN Roadwarrior connections log > > Status / Qos Graphs * > Status / Modem Status > Status / Atm-status > Network / Network configuration * > Firewall / UPnP > IPFire / Help * > Log / Open VPN Log * > > and at least four of those (*) don't appear to exist. There might well > be pages for some of these which I didn't see when I was adding the links. > There are also four pages which obviously require further work: > > Status / Entropy > Status / Connections > Status / MDstat > Network / URL Filter > >> * There is never this “just read one sentence and you suddenly will be > an expert” thing this kind of promotes >> > True. But in the extreme this could be argued to say that IPFire > shouldn't provide any information in the wiki unless it's much more > detailed than the current wiki. Where do you draw the line? Yeah, I suppose I give up this argument. *Some* documentation is better than nothing and people who generally know what they are doing will probably benefit. >> Should we not rather link the wiki somewhere in the footer and > encourage people to start reading the whole thing from the start before > they do something? > > I think the best place for this is either on the download page or in the > installer, so they get prompted to read the wiki before they start playing. I suppose nobody reads the manual before they buy anything. I also do not want to scare anyone away by claiming that IPFire is “for experts only”. It isn’t. > > I suspect putting a link in the footer wouldn't help many people. If > they can't find the wiki on the website they're probably not going to > find it in the GUI footer. I still cannot my head around it why this is a problem. We have search that will find the right page, if you put in the keyword that you will find on top of the page you are currently looking at. And the wiki has exactly the same hierarchy than the web UI. How can this go wrong? >> >> What is your rationale to implementing this? > > I was following the discussion in the community, and several people > seemed to be in favour of the idea. And to quote 'This suggestion has > been made plenty of times. I would be happy to accept patches, but so > far nobody wanted to work on it.' > > So I submitted the patches. I appreciate it, but it would have been nice if we could have had the discussion first and come to a conclusion that everyone can live with. Plenty of people have commented on this. There have been some further threads on the topic - or rather slight spin-offs - and suddenly there was absolute silence. I do not value the opinion of people very much when they only have that to give and are not willing to put any leg work in. In this case: Everyone wants better documentation, but only one(!) person is actually editing it and improving it gradually. It is absolutely not okay for a group of 10 people to tell that one person what they expect them to do. Therefore I personally feel that we are quite far away from what we can actually do here. -Michael > I understand that there are two sides to the argument. Having the wiki > pages linked as help will be beneficial to some people and will just get > other people into a mess quicker when they try to do something they > don't understand - but having a link to the wiki page may help some of > this latter group to realise that they don't understand and need to > learn more. > > Which is going to be of most benefit to most people? I think for me, > having the help links would be preferable, but that's for me, with my > skill set and personality. > > Tim > >> >> Best, >> -Michael >> >