You are Here:
Linux Lite 4.4 Final has been released. See the Release Announcements section for more information.



Need Suggestions for the Help Manual

Author (Read 20817 times)

0 Members and 1 Guest are viewing this topic.

Need Suggestions for the Help Manual
« on: January 06, 2015, 06:54:32 PM »
 

gold_finger

  • Documentation Writer
  • Platinum Level Poster
  • *****
  • 1095
    Posts
  • Country: us
  • Reputation: 323
  • Linux Lite Member

  • Linux Lite: 3.2 64bit

  • CPU: Intel Core2 Duo E7500 3.0GHz

  • MEMORY: 4Gb

  • VIDEO CARD: Intel 4 Series Integrated Graphics
Hi Everyone,

We're looking for ways to improve the Help Manual and would really appreciate your input.  Consider this a kind of free-for-all general brainstorming session.  At this point, any ideas that you think will make the manual better/(more useful) are welcome.  Only real caveat is for you to try limiting suggestions to things that would likely benefit a fair number of people.  (In other words, try to steer clear of topics that would only be of interest to 1 in 100 people.)

Any particular topics that you wish were in the manual but are not right now?

Anything in it already that you think could use further/better explanation?

If you think back to when you first started using Linux (any distro), what are some of the things that were most confusing and that you wish you had good information on from the beginning?

If you have used the help manual to try finding an answer to something, was it easy to find what you were looking for?  Or was it a bit confusing figuring out exactly where to look?

Any suggestions for improving the overall layout of the manual, possibly making it easier to find what you are looking for when using it?

Once we've got a good amount of feedback, we'll go from there and possibly put up a poll for you cast votes for the suggestions you think are most important to start with adding to the manual.

Thanks.
Try Linux Beginner Search Engine for answers to Linux questions.
 


Re: Need Suggestions for the Help Manual
« Reply #1 on: January 06, 2015, 07:04:23 PM »
 

Scott

  • Global Moderator
  • Gold Level Poster
  • *****
  • 858
    Posts
  • Country: 00
  • Reputation: 186
  • Linux Lite Member

  • Linux Lite: 3.4 64bit

  • CPU: Dual core Intel Core i3 M 330

  • MEMORY: 6Gb

  • VIDEO CARD: Intel Integrated Graphics
A "Quick Start" index (like some technical books have at the beginning of a book) to help beginners get off to a quick start by listing a short index of the most commonly asked questions.
 

Re: Need Suggestions for the Help Manual
« Reply #2 on: January 06, 2015, 07:10:29 PM »
 

altman

  • Gold Level Poster
  • *******
  • 741
    Posts
  • Reputation: 43
  • Linux Lite Member
I would think of Files Permissions as some new to Linux have & Root Password , but it s not recommended to new people to Linux .

Not much could be done , I guess it s pretty good as itl is right now .

But ideas will come by as time goes by .
HP DV7 i7 2670QM 500.1GB 8GB Ram Dual-Boot LL2.4 Beta / Extix 15.1.1 64-bit 
Dell Inspiron 1720 CrunchBang 11

Duckduckgo ( for now )
 

Re: Need Suggestions for the Help Manual
« Reply #3 on: January 06, 2015, 07:52:20 PM »
 

misko_2083

  • Gold Level Poster
  • *******
  • 686
    Posts
  • Reputation: 188
  • Linux Lite Member

  • CPU: Dual core Pentium E5700 3GHz

  • MEMORY: 3Gb

  • VIDEO CARD: GeForce GT 430
A "Quick Start" index (like some technical books have at the beginning of a book) to help beginners get off to a quick start by listing a short index of the most commonly asked questions.
I like this idea on Commonly asked questions.
As for the first page I think few lines of icons would be better for navigation in the manual.
 

Re: Need Suggestions for the Help Manual
« Reply #4 on: January 06, 2015, 10:07:38 PM »
 

bitsnpcs

  • Platinum Level Poster
  • **********
  • 3185
    Posts
  • Country: 00
  • Reputation: 299

  • Linux Lite: 3.2 64bit
Dictionary of terminology used in the manual, that new users will not be familiar with.
   
Last Edit: January 10, 2015, 12:59:30 AM by bitsnpcs
 

Re: Need Suggestions for the Help Manual
« Reply #5 on: January 07, 2015, 03:16:59 AM »
 

banko

  • Forum Regular
  • ***
  • 154
    Posts
  • Country: gb
  • Reputation: 16
  • Linux Lite Member

  • Linux Lite: 4.4 64bit

  • CPU: Dual core Celeron CPU T3300 (-MCP-)

  • MEMORY: 4Gb

  • VIDEO CARD: Intel Mobile 4 Series Integrated
Hello,

I'm a relative new comer to LL but not to Linux (no way an expert).

I've just read the manual for the first time and it is actually quite good.

When buying or using something new, the first thing I do is look on You Tube,
for xmas I bought 3 Tablets for my grandchildren and a cycle rack for my son and the You Tube videos where so much better than the instructions that came with the products.

So, just a suggestion, why not create an official You Tube channel, with various videos, especially installation guides, an area that confuses and puts new uses off.

Keith
 

Re: Need Suggestions for the Help Manual
« Reply #6 on: January 07, 2015, 04:58:15 AM »
 

Wirezfree

  • PayPal Supporter
  • Platinum Level Poster
  • *****
  • 1484
    Posts
  • Country: gb
  • Reputation: 404
  • Linux Lite "Advocate"

  • Linux Lite: 2.8 64bit

  • CPU: i7-4790S

  • MEMORY: 16Gb

  • VIDEO CARD: Intel HD4600 (Integrated)
Hi gold_finger,

I think a couple of the challenges when you first start with LL(Linux),

1. Where do I start.?, The user manual, so this should be the key focus.
    Coming from Windows where for a user it was more or less switch it on, follow the install prompts/guide and away you go.

2. Then there is the terminology, already mentioned by bitsnpcs(good one),
    An A-Z of the most common "terms" and "commands" would be useful. So 2 new sections?
    > FAQ = Frequently Asked Questions, there could be links back to any already existing "How To's" in the Forum
    > CUC = Commonly Used Commands, These are the ones that people like yourself ask for on a regular basis.

3. I think there is already an enormous amount of information, answers and solutions within the forum...But
    If you are new and not familiar with LL(Linux), and maybe English is not your 1st language, deciding what to "search" for can be a challenge.

    This one is more a challenge, and potentially to much of a resource burden and drain on people like your good self...
    It needs the creations of some form indexed/reference knowledge section with just one liners, bit like a mini-wiki.
    See if I can explain,, Create a section, say "Common & Known Solutions and Answers"
    Break it into Key subject areas, Install , Software , Hardware and Configuration
    There would be sub categories under each of the main subject areas, These get added to when new subjects arise.
    Now each time a solution to an an issue/question is found, a one liner and link to the relevant post/source is added in the relevant category.
   
    Example of how it could work/look,, I'm having an issue with a Bluetooth Device,
    So I go and look in the Hardware > Bluetooth section
    I see some one liners, and something that sounds like my issue, and a link to click on, like this...
    Hardware
           Bluetooth
           One liner 1 + Link
           One liner 2 + Link
           Enabling Full Bluetooth Support in Linux Lite = https://www.linuxliteos.com/forums/index.php?topic=558.0
           One liner 3 + Link

Just my thoughts...
Obviously, like I said, it would put a lot on the shoulders of the mods & devs, and maybe just to much of an ask..??
and like all knowledge systems they are are only as good as the content, and relevance = "Ongoing Maintenance"
Otherwise they become stale and out of date.

Dave
Last Edit: January 07, 2015, 04:15:15 PM by Wirezfree
Upgrades WIP 2.6 to 2.8 - (6 X 2.6 to 2.8 completed on: 20/02/16 All O.K )
Linux Lite 3.0 Humming on a ASRock N3070 Mobo ~ btrfs RAID 10 Install on 4 Disks :)

Computers Early days:
ZX Spectrum(1982) , HP-150 MS-DOS(1983) , Amstrad CPC464(1984) ,  BBC Micro B+64(1985) , My First PC HP-Vectra(1987)
 

Re: Need Suggestions for the Help Manual
« Reply #7 on: January 07, 2015, 04:08:39 PM »
 

gold_finger

  • Documentation Writer
  • Platinum Level Poster
  • *****
  • 1095
    Posts
  • Country: us
  • Reputation: 323
  • Linux Lite Member

  • Linux Lite: 3.2 64bit

  • CPU: Intel Core2 Duo E7500 3.0GHz

  • MEMORY: 4Gb

  • VIDEO CARD: Intel 4 Series Integrated Graphics
Lots of good suggestions!  Thanks to all who posted so far.

Going to leave this open for a few days at least (probably through the weekend) to give plenty of time for others to put in ideas and to give everyone a chance to add things that might come to mind after their initial posts.
Try Linux Beginner Search Engine for answers to Linux questions.
 

Re: Need Suggestions for the Help Manual
« Reply #8 on: January 07, 2015, 07:03:55 PM »
 

rokytnji

  • Friganeer
  • Platinum Level Poster
  • **********
  • 1257
    Posts
  • Country: us
  • Reputation: 134

  • Linux Lite: 3.6 64bit

  • CPU: Intel Core2 Duo U9600

  • MEMORY: 4Gb

  • VIDEO CARD: Intel Mobile 4
Just to show what one member of our crew does

LINK

and we are a small but mighty team.
Last Edit: January 08, 2015, 07:42:41 AM by rokytnji
LL 3.6,2.8
Dell XT2 > Touchscreen Laptop
Dell 755 > Desktop
Acer 150 > Desktop
I am who I am. Your approval is not needed.
 

Re: Need Suggestions for the Help Manual
« Reply #9 on: January 07, 2015, 08:02:21 PM »
 

gold_finger

  • Documentation Writer
  • Platinum Level Poster
  • *****
  • 1095
    Posts
  • Country: us
  • Reputation: 323
  • Linux Lite Member

  • Linux Lite: 3.2 64bit

  • CPU: Intel Core2 Duo E7500 3.0GHz

  • MEMORY: 4Gb

  • VIDEO CARD: Intel 4 Series Integrated Graphics
Hi rokytnji,

For some reason I get "this video doesn't exist" when I click it.  Did you post correct link, or do you think it got deleted?
Try Linux Beginner Search Engine for answers to Linux questions.
 

Re: Need Suggestions for the Help Manual
« Reply #10 on: January 07, 2015, 09:09:41 PM »
 

bitsnpcs

  • Platinum Level Poster
  • **********
  • 3185
    Posts
  • Country: 00
  • Reputation: 299

  • Linux Lite: 3.2 64bit
1/ the Linux Cheat Sheet Jerry posted, as an index of commands for experienced users. 

2/  https://www.linuxliteos.com/forums/index.php?topic=1167.msg8557#msg8557
Last Edit: January 10, 2015, 12:59:50 AM by bitsnpcs
 

Re: Need Suggestions for the Help Manual
« Reply #11 on: January 08, 2015, 07:44:18 AM »
 

rokytnji

  • Friganeer
  • Platinum Level Poster
  • **********
  • 1257
    Posts
  • Country: us
  • Reputation: 134

  • Linux Lite: 3.6 64bit

  • CPU: Intel Core2 Duo U9600

  • MEMORY: 4Gb

  • VIDEO CARD: Intel Mobile 4
Hi rokytnji,

For some reason I get "this video doesn't exist" when I click it.  Did you post correct link, or do you think it got deleted?

My bad. I did not realize how the forum slices up a youtube link into just the last numbers after V=.

Anyways. I fixed it.
LL 3.6,2.8
Dell XT2 > Touchscreen Laptop
Dell 755 > Desktop
Acer 150 > Desktop
I am who I am. Your approval is not needed.
 

Re: Need Suggestions for the Help Manual
« Reply #12 on: January 08, 2015, 03:35:29 PM »
 

gold_finger

  • Documentation Writer
  • Platinum Level Poster
  • *****
  • 1095
    Posts
  • Country: us
  • Reputation: 323
  • Linux Lite Member

  • Linux Lite: 3.2 64bit

  • CPU: Intel Core2 Duo E7500 3.0GHz

  • MEMORY: 4Gb

  • VIDEO CARD: Intel 4 Series Integrated Graphics
@rokytnji,

Thanks -- link works now.  That's pretty impressive.  Something to consider for sure later on after we get the manual squared away.


@everyone,

Thanks again for the input.  Keep the ideas coming.

Just to let you all know ahead of time -- I'm purposely trying to comment as little as possible on the ideas you are putting  up for right now.  I don't want to end up influencing the direction things go in.  Figure that way things will stay in more of a free-flowing mode.  So don't mistake my lack of reaction to specific ideas as me not liking them or not appreciating them.  I'll tell you right now that I like a lot of what I'm seeing and you're pointing things out that I hadn't thought of before.  So, keep up the good work.
Last Edit: January 08, 2015, 03:45:29 PM by gold_finger
Try Linux Beginner Search Engine for answers to Linux questions.
 

Re: Need Suggestions for the Help Manual
« Reply #13 on: January 08, 2015, 08:49:57 PM »
 

altman

  • Gold Level Poster
  • *******
  • 741
    Posts
  • Reputation: 43
  • Linux Lite Member
Just found another idea from helping a mate in the Forum .

How LeafPad works , its functions & how to save commands in it .
HP DV7 i7 2670QM 500.1GB 8GB Ram Dual-Boot LL2.4 Beta / Extix 15.1.1 64-bit 
Dell Inspiron 1720 CrunchBang 11

Duckduckgo ( for now )
 

Re: Need Suggestions for the Help Manual
« Reply #14 on: January 09, 2015, 10:26:59 AM »
 

altman

  • Gold Level Poster
  • *******
  • 741
    Posts
  • Reputation: 43
  • Linux Lite Member
Another one from someone in the forum , What to do when someone has broken updates .

Post #3 of this thread : https://www.linuxliteos.com/forums/index.php?topic=1257.msg8279#msg8279
Last Edit: January 09, 2015, 10:38:14 AM by altman
HP DV7 i7 2670QM 500.1GB 8GB Ram Dual-Boot LL2.4 Beta / Extix 15.1.1 64-bit 
Dell Inspiron 1720 CrunchBang 11

Duckduckgo ( for now )
 


Tags:
 


Linux Lite 4.4 Final has been released. See the Release Announcements section for more information.