PCLinuxOS-Forums
News: ...FLASH!!! ...New PCLinuxOS Testing board now open. Register today! Be an active contributor to the PCLinuxOS future! ... Read all about it now, on THIS forum!!!..
 
*
Welcome, Guest. Please login or register. May 27, 2012, 03:06:19 AM


Login with username, password and session length


Pages: [1] 2   Go Down
  Print  
Author Topic: PCLinuxOS Help Handbook  (Read 2117 times)
Fargo
Hero Member
*****
Offline Offline

Posts: 829


« on: October 29, 2010, 11:30:40 AM »

I'm not sure if this is the right place for this requires or not but here goes. 


As I recently installed PCLOS 2010KDE things went pretty smoothly.  But I did have some issues with my network and later, in trying to make things look fancy, I crashed my system trying to install windows decorations.  (I didn't know I had to turn on 3D effects to get translucent windows).  I know there are tons of helpful articles in the PCLOS magazine, but when I am working on my system I don't think about going online to the magazine for help.  But if these articles could be integrated into a searchable database that would make an awesome help handbook.  It seems that for most applications when you click on the help button it just takes you to KDE help.  It would be nice if PCLOS had their own help handbook that gave further information on setting up and how to use certain features.  It seems to me that most of the work has already been done by the PCLOS magazine team.  How hard would it be to put those articles into a file on the PC that was indexed and searchable?

Logged
melodie
Hero Member
*****
Offline Offline

Posts: 6005


XMMP=Jabber, free instant messaging protocol !


WWW
« Reply #1 on: October 29, 2010, 12:00:35 PM »

Hi,

You could start with downloading them all: http://pclosmag.com/index.php/downloads
in one click or not much more, ie with Firefox extention "Download them all" ?

So you would have them already in a directory in your system.
Actually PCLinuxOS distribution generally don't install docs as they take quite some space in an iso, space that can be used for adding applications. That's a choice...

Logged

melodie at swissjabber dot ch - IRC #pclinuxos-fr sur freenode
Joble
Global Moderator
Hero Member
*****
Offline Offline

Posts: 6848


USA - Mountain Time


« Reply #2 on: October 29, 2010, 12:00:49 PM »

Something like this?
Magazine Article Index/Search
Logged

Search First.
Forum Rules
Hero means I talk a lot, nothing more, nothing less!
Have an Awesome Day!
Healthy System
Fargo
Hero Member
*****
Offline Offline

Posts: 829


« Reply #3 on: October 29, 2010, 12:32:36 PM »

Something like this?
Magazine Article Index/Search



Yes, something like that is what I was looking for.  I think it would be a good idea to have a link to that page on the desktop to allow new users a place to get more info on their system.  The forum is great, but I think a lot of newbie questions could be answered by this page and they(we) might be able to learn the correct way to do things before we crash our system and need the forums help.

I think a link would be very helpful and useful to many people.  Plus a link would not take up any noticable space on the live cd.  Along with the link maybe they could add the option to 'Get PCLOS Magazine Help files'  With this option they could download all the files as melodie mentioned.  If these files could be downloaded to the PC and viewed in a searchable layout like the webpage is, they would create a wonder PCLOS Handbook.

OK so now how do I go about recommending this to Tex and the Gang for consideration for the next update/release?

Logged
Joble
Global Moderator
Hero Member
*****
Offline Offline

Posts: 6848


USA - Mountain Time


« Reply #4 on: October 29, 2010, 12:43:37 PM »

Uh...... I think you just did.

BTW:  The link to the magazine should already be there in your browser.
Logged

Search First.
Forum Rules
Hero means I talk a lot, nothing more, nothing less!
Have an Awesome Day!
Healthy System
parnote
Moderator
Hero Member
*****
Offline Offline

Posts: 3968


The truth is out there ... PCLinuxOS!


« Reply #5 on: October 29, 2010, 03:53:35 PM »

Fargo,

I think it's a very good idea!

parnote
Logged

PCLinuxOS Magazine Chief Editor

Linux Registered User #485009

In a world without walls, who needs Windows?

PCLinuxOS Wiki: Contribute tips/tricks/how-to's!
Fargo
Hero Member
*****
Offline Offline

Posts: 829


« Reply #6 on: October 29, 2010, 04:16:11 PM »

Fargo,

I think it's a very good idea!

parnote

Thank you.  I hope that it gets some traction.  I'd really like to see something like this available to PCLOS users.  I actually got the idea a few years ago when I tried Mepis.  They have (or did at that time) a nice user help file.  I think by utilizing all the work that has gone into the PCLOS Magazine, PCLOS could have a well documented and complete handbook as well. 






Logged
Was_Just19
Hero Member
*****
Offline Offline

Posts: 6885


MLU


« Reply #7 on: October 29, 2010, 04:26:45 PM »

I agree .......  that is something that the distro could benefit from having.

If space allowed I would have the file installed with a link on the default desktop.

.....  wondering if the mag has the resources to get this together .......  but it would be a great project if it does,  IMO .......
Logged
Fargo
Hero Member
*****
Offline Offline

Posts: 829


« Reply #8 on: October 29, 2010, 04:47:20 PM »

I agree .......  that is something that the distro could benefit from having.

If space allowed I would have the file installed with a link on the default desktop.

.....  wondering if the mag has the resources to get this together .......  but it would be a great project if it does,  IMO .......

That would be my preferred option as well. 
Logged
melodie
Hero Member
*****
Offline Offline

Posts: 6005


XMMP=Jabber, free instant messaging protocol !


WWW
« Reply #9 on: October 29, 2010, 05:10:40 PM »

Hi,

Do you mean just a link to click at to open the browser and be brought at that page, or a link with the Firefox icon that bring you to that page when you click on it ?

For example, a simple link, which does not require any work (just change the name of the file):


(Don't pay attention to the "Fichiers2" directory... this is personal).

Logged

melodie at swissjabber dot ch - IRC #pclinuxos-fr sur freenode
parnote
Moderator
Hero Member
*****
Offline Offline

Posts: 3968


The truth is out there ... PCLinuxOS!


« Reply #10 on: October 29, 2010, 05:15:20 PM »

I agree .......  that is something that the distro could benefit from having.

If space allowed I would have the file installed with a link on the default desktop.

.....  wondering if the mag has the resources to get this together .......  but it would be a great project if it does,  IMO .......

The resources aspect is a biggie, but perhaps a PDF file (kept as light as possible) with relevant searches linked to the relative area (e.g., with the search criteria already filled in?). There are a few of us who are doing layout, plus another member of the staff just getting started with layout.

Certainly something to discuss.

parnote
Logged

PCLinuxOS Magazine Chief Editor

Linux Registered User #485009

In a world without walls, who needs Windows?

PCLinuxOS Wiki: Contribute tips/tricks/how-to's!
Was_Just19
Hero Member
*****
Offline Offline

Posts: 6885


MLU


« Reply #11 on: October 29, 2010, 05:52:36 PM »

I agree .......  that is something that the distro could benefit from having.

If space allowed I would have the file installed with a link on the default desktop.

.....  wondering if the mag has the resources to get this together .......  but it would be a great project if it does,  IMO .......

The resources aspect is a biggie, but perhaps a PDF file (kept as light as possible) with relevant searches linked to the relative area (e.g., with the search criteria already filled in?). There are a few of us who are doing layout, plus another member of the staff just getting started with layout.

Certainly something to discuss.

parnote

That sounds like it would be sufficient for anyone who would be using it ........  basic info in the PDF and more detailed info from a link.

regards.
Logged
TerryH
Sr. Member
****
Offline Offline

Posts: 469



« Reply #12 on: October 29, 2010, 08:03:43 PM »

Something like this?
Magazine Article Index/Search



What a fantastic reference.  Thank you.
Logged

https://linuxcounter.net/cert/542348.png

Aussie, Aussie, Aussie........Eh!,  Eh!,  Eh!
Fargo
Hero Member
*****
Offline Offline

Posts: 829


« Reply #13 on: October 29, 2010, 09:09:12 PM »

Hi,

Do you mean just a link to click at to open the browser and be brought at that page, or a link with the Firefox icon that bring you to that page when you click on it ?

For example, a simple link, which does not require any work (just change the name of the file):


(Don't pay attention to the "Fichiers2" directory... this is personal).




I think something like that as a BARE MINIMUM would work.  Although I would label it "PCLinuxOS online Users Manual" or something along that line so those new to PCLOS will know that it is a reference book containing help files. 

Ultimately though, I'd like to see a help file that could be downloaded directly onto the system using a "Get PCLinuxOS Users Manual" icon or something like that.  Maybe a pdf file as Parnote mentioned.  Also, I think its important to label it as a users manual.  Otherwise the casual user may think its just some geek magazine.  You can give credit to the PCLOS Magazine team when the dialog opens and in the 'About PCLOS Users Manual" section.

I think a searchable/indexed pdf file as Parnote mentioned might work ok.  I was also wondering if you could you use the same program that the KDE Help Center uses?  That appears to be a searchable data center.  Could you use the same basic program that the KDE Help Center uses to open the PCLOS User Manual? Could you import the data and the basic layout that's already setup on the PCLOS Magazine website into that program?  You may want to give is a different appearance but would that work? 
Logged
parnote
Moderator
Hero Member
*****
Offline Offline

Posts: 3968


The truth is out there ... PCLinuxOS!


« Reply #14 on: October 30, 2010, 07:53:05 PM »

I think something like that as a BARE MINIMUM would work.  Although I would label it "PCLinuxOS online Users Manual" or something along that line so those new to PCLOS will know that it is a reference book containing help files. 

Ultimately though, I'd like to see a help file that could be downloaded directly onto the system using a "Get PCLinuxOS Users Manual" icon or something like that.  Maybe a pdf file as Parnote mentioned.  Also, I think its important to label it as a users manual.  Otherwise the casual user may think its just some geek magazine.  You can give credit to the PCLOS Magazine team when the dialog opens and in the 'About PCLOS Users Manual" section.

I think a searchable/indexed pdf file as Parnote mentioned might work ok.  I was also wondering if you could you use the same program that the KDE Help Center uses?  That appears to be a searchable data center.  Could you use the same basic program that the KDE Help Center uses to open the PCLOS User Manual? Could you import the data and the basic layout that's already setup on the PCLOS Magazine website into that program?  You may want to give is a different appearance but would that work? 

All of your ideas are good ones. The problem (that I see) is still a problem of resources. My perspective may be a bit different, having served as the magazine's chief editor for well over a year. For example, I know how "difficult" it sometimes is to come up with articles for the magazine. And there are a myriad of reasons ... someone doesn't think they are a good enough writer ... another person promises articles (with great intentions) but never follows through or produces them ... "life" gets in the way, which is a huge one, given the fact that all of us who contribute to the magazine volunteer our time and services, and each of us has to hold down jobs, families, and all the responsibilities that go along with them ... and some folks just simply "move on."

Also, each time there was a new major release of PCLinuxOS, or there was a new major release of a desktop environment (such as what happened when KDE moved from 3.5.x to 4.x, or the upcoming release of Gnome 3.0), it would require some serious re-writes to remain current, if it's to be truly helpful.

Like I said, your ideas are great ones, and the plan is ambitious, even for a commercial OS with lots of resources and $$$ and paid staff. Even some of the "best" documentation for Windows comes from third-party publishers ... NOT Microsoft (who tends to suck at documenting their own stuff).

If we were to attempt something on a smaller scale, all of these things will need to be taken into consideration. And, most likely, it will require the user to at least have a net connection. One way that I've tried to bridge the gap is with the production of the "special editions" of the magazine. Recently, we've released the KDE 4 Special Edition and the Command Line Interface Intro Special Edition. There are additional "special editions" of the magazine planned for the near future.

I'm certainly open to any and all suggestions (and discussion) on this topic.

Paul Arnote [parnote]
PCLinuxOS Magazine Chief Editor
Logged

PCLinuxOS Magazine Chief Editor

Linux Registered User #485009

In a world without walls, who needs Windows?

PCLinuxOS Wiki: Contribute tips/tricks/how-to's!
Pages: [1] 2   Go Up
  Print  
 
Jump to:  

Powered by MySQL Powered by PHP Powered by SMF 1.1.16 | SMF © 2011, Simple Machines

Valid XHTML 1.0! Valid CSS! Dilber MC Theme by HarzeM