PCLinuxOS Help Handbook

[Fargo]

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

Ahh, I see what you are saying.  For some reason when you said resources I was thinking system resources, not people resources.  In that case a simple link to the indexed PCLOS Mag would be a good start and easy enough to incorporate.  Also since the articles are already in a HTML format would it be possible to download them all in html and let firefox open them?  I have no programing experience here so I'm just throwing out ideas. 

[parnote]

 

It's a good idea. Let's explore it and see what we can do.

parnote

[melodie]

It's a good idea. Let's explore it and see what we can do.

parnote

Hi,

Here is a desktop file I just did, to put on the /home/user/Desktop:

[Desktop Entry]
Encoding=UTF-8
Icon=/usr/share/icons/web_browser_section.png
Name=PCLinuxOS Magazine
Name[fr]=Magazine PCLinuxOS
Type=Link
URL=/usr/share/doc/HTML/WelcomePCLinuxOSmag.html
Comment=Visit our PCLinuxOS Magazine
GenericName=

You can call it "pclinuxos-magazine.desktop".

In /usr/share/doc/HTML there would be a file named WelcomePCLinuxOSmag.html : I just did "File>Save as" → WelcomePCLinuxOSmag.html in Firefox at the main page of the PCLinuxOS Magazine, the file is in my tmp directory. I opened it again with Firefox and it comes out same as on the website. I tried just before at the index page but there it does not look same, it looks like it misses the style sheet.

The icon name is the generic web browser icon, I have it in my system.

With a html page coming from the site, in /usr/share/doc/HTML, and this desktop file, you ought to have the link on desktop directly. The "Comment=" might allow to know more about the link, thanks to a info text as hover. The name of the link itself should be as short as possible because it does not show well on desktop otherwise : it's cut at the wrong place in the word.

I am pretty sure parnote knows all this already, but I wanted to explain the details for the persons who begin and might like to know how to do it. This desktop file is meant for links only, and can be reused for other things, such as docs for example.