-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1

Dimitris Glezos escribió:

The discussion about the writing style and the effect it has reminded me that it would be a good idea to make a PDF format of our guides. People prefer to read tutorials in print. (Especially if it's the installation guide!)

Furthermore, I believe that writing documentation with a printable result in mind, probably produces better content. To be honest, if there was a way we could get the desktop guide and probably a troubleshoot guide in PDF, I might jump into translating them, install Fedora for my father at home tomorrow and hand him the guides for the rest.

So, suggestions: First fix the PDF-creation problems and having a goal in the back of our minds to create a nice printable PDF with the most useful guides bundled together (installation, desktop, administration, FAQ and Troubleshoot)?

Last discussions I found about PDFs are the following:

http://www.redhat.com/archives/fedora-docs-list/2006-March/msg00145.html

http://www.redhat.com/archives/fedora-docs-list/2006-January/msg00179.html

Any thoughts about this? Suggestions, steps, problems, blah?

-dim

This is a good idea. I was in the process of writing a "basic system administration" using only the system-config* tools and other tools for new users, i.e only those basic concepts to keep the system is "sane". I could write this in English and make it part of the project, however I don't know if there is already something like this in place.

On Fri, 2006-09-01 at 19:38 +0100, Dimitris Glezos wrote:

So, suggestions: First fix the PDF-creation problems and having a goal in the back of our minds to create a nice printable PDF with the most useful guides bundled together (installation, desktop, administration, FAQ and Troubleshoot)?

Last discussions I found about PDFs are the following:

• http://www.redhat.com/archives/fedora-docs-list/2006-March/msg00145.html
• http://www.redhat.com/archives/fedora-docs-list/2006-January/msg00179.html

Any thoughts about this? Suggestions, steps, problems, blah?

It looks like PDF building works somewhat on some docs right now, in that it produces an actual loadable PDF, which looks... well, not great. The stylesheet is apparently terrible, and breaks pages for subsections in weird places. If you want to take up this particular challenge, you sure have my blessing (and good-luck wishes!). I know Apache FOP was a contender but we need it to work using GCJ to consider it seriously, since we need a 100% free tool stack.