Linux Lite Forums

General => Suggestions and Feedback => Topic started by: Jerry on November 24, 2016, 10:13:27 PM

Title: Help Manual Suggestions wanted
Post by: Jerry on November 24, 2016, 10:13:27 PM
I'm going to spend some time between now and 3.4 to add to the Help Manual. If there is anything I have overlooked, please let me know in this thread.

- An example of a good suggestion - the recent "Lite Software - Change Repository Location" suggestion from another thread.
- An example of a bad suggestion - "Please include a tutorial for installing KDE"

Any suggestion must be relevant to what we already offer.

Thank you :)
Title: Re: Help Manual Suggestions wanted
Post by: rokytnji on November 24, 2016, 10:26:31 PM
http://manpages.ubuntu.com/manpages/trusty/man1/inxi.1.html

Not sure if already included or wanted. Since it is non GUI application tool. I use it alot myself and help others online  trouble shoot problems with it.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on November 24, 2016, 10:30:29 PM
I'm looking for 'point and click' tutorials - think Grandma who has never used a pc before, and her first experience is Linux Lite. That basic.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on November 25, 2016, 02:07:11 AM
I've added some new content to the Manual (online Manual shows these). Would someone mind writing up a short, plain English explanation of what Wine is and what you use it for? Thank you.
Title: Re: Help Manual Suggestions wanted
Post by: ralphy on November 25, 2016, 07:16:25 PM
I've added some new content to the Manual (online Manual shows these). Would someone mind writing up a short, plain English explanation of what Wine is and what you use it for? Thank you.


In short (plain English explanation):

Quote
Wine application is a compatibility layer capable of running many Windows programs in Linux.


A bit more descriptive: 

Quote
Wine application is a compatibility layer capable of running many Windows programs in Linux. Software programs are designed for different operating systems, and most won't work on systems that they weren't designed for.

Windows programs won't natively run in Linux because they contain instructions that the system can't understand until they're translated by the Windows environment. In that same way, Linux programs won't run under the Windows operating system because Windows is unable to interpret all of their instructions.

Through Wine's compatibility layer, when a Windows program tries to perform a function that Linux doesn't normally understand, Wine will translate that program's instruction into one supported by Linux.


I think that's plain enough, and boldly describes what it is and what it does.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on November 25, 2016, 09:17:33 PM
Thank you ralphy, perfect, new info added to the Help Manual.
Title: Re: Help Manual Suggestions wanted
Post by: LL-user on December 20, 2016, 02:53:32 AM
Small typo in:
 Systemback - Creating a Live ISO of your installation
(/usr/share/doc/litemanual/tutorials.html#systembackiso)

currently it reads:
Quote
Leave the options are they are shown in the image below.

expected:
Quote
Leave the options as they are shown in the image below.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on December 20, 2016, 03:03:07 AM
Thanks LL-user, all fixed via github.
Title: Re: Help Manual Suggestions wanted
Post by: LL-user on December 20, 2016, 03:23:16 AM
Do you prefer stuff like this logged via GitHub?
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on December 20, 2016, 03:24:27 AM
Do you prefer stuff like this logged via GitHub?

Yes please, just start a new Issue.
Title: Re: Help Manual Suggestions wanted
Post by: LL-user on December 20, 2016, 03:42:11 AM
OK, will do in the future for issues.

Suggestions I'll still post here for discussion. Like the following one :)

Greatest improvement for the already outstanding Help Manual I would consider the implementation of a search functionality.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on December 20, 2016, 10:27:34 AM
OK, will do in the future for issues.

Suggestions I'll still post here for discussion. Like the following one :)

Greatest improvement for the already outstanding Help Manual I would consider the implementation of a search functionality.

You can submit that as an Issue on Github. I would then label it as an 'enhancement'. I've previously looked at ways to include an offline search function in the Help Manual. I'm willing to entertain suggestions for a solution. It has to be offline as the Help Manual still needs to be searched if someones internet connection goes down.
Title: Re: Help Manual Suggestions wanted
Post by: LL-user on December 20, 2016, 06:53:26 PM
done :)
Title: Re: Help Manual Suggestions wanted
Post by: mookie on January 01, 2017, 05:18:07 PM
FYI, here's a page that explains step-by-step how aptosid uses "recoll" indexer to achieve an offline search for their user manual

h t t p : / / manual.aptosid.com/en/manual-search-en.htm
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on January 01, 2017, 10:32:26 PM
FYI, here's a page that explains step-by-step how aptosid uses "recoll" indexer to achieve an offline search for their user manual

h t t p : / / manual.aptosid.com/en/manual-search-en.htm


Thanks mookie, I'll take a look.
Title: Re: Help Manual Suggestions wanted
Post by: bitsnpcs on January 21, 2017, 12:04:26 AM
Keyboard shortcuts to close a software window, to reduce a software and show the desktop (where the software covers the taskbar desktop icon).

The link to xfcelook in mouse theme section needs updating.
Title: Re: Help Manual Suggestions wanted
Post by: montylfp on February 10, 2017, 09:11:03 PM
Had an embarrassing thing happen to me today. Long story short, I attempted to get Samba operating for use on a Windows 10 machine. I followed this tutorial in your help manual to the letter:

https://www.linuxliteos.com/manual/network.html#shares

After that, I could see the machine over my LAN on the Windows 10 machine, but simply could not access it, with Windows throwing me error messages about being unable to access. After much furious Googling and tearing my hair out, a thought occurred to me that should have hours before: What if the Linux Lite firewall is interfering?

As luck would have it, that was it. I disabled it real quick and suddenly everything worked.

I'm an intermediate-level user (though I guess not because this didn't occur to me sooner), but a beginner might not realize to check for firewall settings. I think some mention of the firewall on this page would be a good idea so that others don't have issues like I did.

TL;DR: Please add some mention of the firewall in the Networking section of the guide, at least in regards to the Samba sharing configuration section. I think it would greatly benefit certain users, as out-of-the-box this feature will not function with the default firewall settings.

P.S. Whenever a not-too-Linux-or-otherwise-computer-savvy person needs a non-Windows OS, I invariably suggest using this. I've met some real computer illiterates who could use this without issue. I've even considered using this myself full-time once or twice. Thank you for all your hard work, I hope this small suggestion can help.
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on February 10, 2017, 09:19:50 PM
Thanks, I'll add a note about the Firewall to the next version of the Help Manual.
Title: Re: Help Manual Suggestions wanted
Post by: m654321 on February 11, 2017, 01:20:28 AM
Jerry, I've already posted this suggestion elsewhere.

There exist published paperback guides for Ubuntu and  Linux Mint - you can find them on Amazon.com.  Please could LL also do this. At least some of us (maybe many..?) would prefer a hard copy of the Manual. There are too many pages to print out (200 to 300)

A paperback copy on Amazon would be another way of advertizing LL, getting it out there to the general public.  Obviously, any profits from the sale of this could then be ploughed back in for LL development.

Maybe to check the level of interest of such a project, you could do a forum survey ...

Many thanks for reading this
Mike
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on February 11, 2017, 03:27:35 AM
@m654321, I have seen your suggestion previously. Simply put, I don't have the time to undertake a project of that magnitude. If someone would like to take it on, I'd be more than happy to reimburse them. Cheers.
Title: Re: Help Manual Suggestions wanted
Post by: m654321 on February 11, 2017, 03:53:28 AM
Thanks Jerry.  Yes, it would be quite a bit of work..  :-\
Title: Re: Help Manual Suggestions wanted
Post by: trinidad on February 11, 2017, 10:30:02 AM
montylafp:

The LL firewall does not interfere with Samba on my several setups to Windows 10 connections even on ad hoc wifi addresses, nor on RDP either. It is only a factor with SSH and SFTP connections Linux to Linux. Windows sorts its own settings in Samba and SFTP through the share settings. Your Windows 10 share settings are not correct.

TC 
Title: Re: Help Manual Suggestions wanted
Post by: trinidad on February 11, 2017, 11:15:22 AM
I would be willing to write a text only basic installation manual formatted like the Debian installation manual (cheap to print and produce) with an expanded networking section. If graphics are necessary someone else would have to provide them after the fact. Also someone else would have to write the UEFI section though most of that could be lifted from Ubuntu. It would take me a couple of months I'm sure, and probably have to be edited and added to after the end of 3.x series.

TC   
Title: Re: Help Manual Suggestions wanted
Post by: m654321 on February 15, 2017, 06:03:19 AM
Lite Tweaks ...

It would be great if the next update of the LL Manual gives the command-line for each of the applications listed in Lite Tweaks (or at least as many of them as possible). 

This would be much appreciated for someone trying to get to grips with command-line...

Cheers  :)
Mike
Title: Re: Help Manual Suggestions wanted
Post by: crazysquirrel on March 06, 2017, 05:01:12 PM
I haven't seen anything on how to access, install, setup, or change printers, all in one's, etc.
Title: Re: Help Manual Suggestions wanted
Post by: firenice03 on March 06, 2017, 05:08:39 PM
I haven't seen anything on how to access, install, setup, or change printers, all in one's, etc.

Here's the section in the manual - scrolling down there is a section for HP's..
https://www.linuxliteos.com/manual/hardware.html#printer

If you could post the model, some could get more specific..

Title: Re: Help Manual Suggestions wanted
Post by: crazysquirrel on March 07, 2017, 09:37:19 AM
I've added some new content to the Manual (online Manual shows these). Would someone mind writing up a short, plain English explanation of what Wine is and what you use it for? Thank you.


In short (plain English explanation):

Quote
Wine application is a compatibility layer capable of running many Windows programs in Linux.


A bit more descriptive: 

Quote
Wine application is a compatibility layer capable of running many Windows programs in Linux. Software programs are designed for different operating systems, and most won't work on systems that they weren't designed for.

Windows programs won't natively run in Linux because they contain instructions that the system can't understand until they're translated by the Windows environment. In that same way, Linux programs won't run under the Windows operating system because Windows is unable to interpret all of their instructions.

Through Wine's compatibility layer, when a Windows program tries to perform a function that Linux doesn't normally understand, Wine will translate that program's instruction into one supported by Linux.


I think that's plain enough, and boldly describes what it is and what it does.

You may want to add a disclaimer of sorts.

WINE will not run *most* windows software.

In particular some of those that require .net framework may not install or run properly or those requiring certain windows components.

WINE will not work with many blood sugar testers, GPS devices, etc. when you plug in the device to download/upload readings or obtain updates.

Before seeking WINE to resolve a program need, look here:

http://www.linuxalt.com/

WINE cannot play some high end video games or will not play satisfactorily.

Some internet places may require the use of a full version of Windows (not too many and the list is getting shorter). Generally some of those sites require internet exploder.

Sometimes it is better to run a full version of windows inside a virtual machine than to use WINE.

PlayOnLinux is a companion to WINE. It may help with getting games to play.

Also, a warning!
If you install WINE, you must install a suitable antivirus/antimalware as you can introduce malware into your linux system inadvertently.

For game players - you can install STEAM, but that too is quite limited.

Look here for additional information:

https://itsfoss.com/linux-gaming-guide/

Here is one place that can help with issues but it is not free-

https://www.codeweavers.com/

Codeweavers (WINE is based on this) is pretty awesome but it still cannot run every Windows software.

If all else fails and you just 'GOTTA HAVE' that certain game or software and when the above doesn't work or work well enough for you, you can consider dual booting linux and windows (not always successful but many times it does work)

Personal note: I have tried may ways like the above with varying success. Best order I have found is this:
1) Get Linux equivalent               (Usually works)
2) Dual booting                            (mostly unsuccessful)
3) Virtual machine                       (Mostly successful)
4) WINE                                       (sometimes works)
5) Use two different computers   (Always works)
Title: Re: Help Manual Suggestions wanted
Post by: Jerry on March 07, 2017, 10:23:46 AM
Thank you crazysquirrel.

Sent from my mobile phone using Tapatalk

Title: Re: Help Manual Suggestions wanted
Post by: ralphy on March 28, 2017, 08:40:04 PM
Had an embarrassing thing happen to me today...

TL;DR: Please add some mention of the firewall in the Networking section of the guide, at least in regards to the Samba sharing configuration section. I think it would greatly benefit certain users, as out-of-the-box this feature will not function with the default firewall settings.

Well, we wanted to come back to this and thank you for your feedback. We've made some changes in Network Share Settings to help with the initial setup. I think we have accomplished just that.

https://youtu.be/Y5Cdobq2o1o
Title: Re: Help Manual Suggestions wanted
Post by: Scott on March 29, 2017, 01:46:52 AM
 :)  Excellent video, Ralphy, appreciate all your great contributions.
Title: Re: Help Manual Suggestions wanted
Post by: ralphy on March 29, 2017, 03:28:45 AM
(http://i.imgur.com/lLwxYy2.jpg)