LDP
/
LDP
mirror of https://github.com/tLDP/LDP
0
1
Fork 0
Code Releases Activity

updated

This commit is contained in:
gferg 2003-11-09 23:31:30 +00:00
parent 01553d771d
commit 13c881efb4
1 changed files with 14 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
LDP/faq/docbook/LDP-FAQ.xml
View File

@ -58,35 +58,35 @@ Initial Release, reviewed by LDP
<qandaentry>
<question><para>What is a Guide?</para></question>
<answer><para>A guide is typically a longer book with broader coverage of a subject. For instance, Network Administration or User Guide. The intent is to understand the whole subject, as opposed to performing only one task. If you want to have a broader look at some aspect of Linux then the guides should be very handy.</para></answer>
<answer><para>A guide is typically a longer book with broader coverage of a subject; for instance, the Network Administration or User Guide. The intent is to understand the whole subject, as opposed to performing only one task. If you want to have a broader look at some aspect of Linux then the guides should be very handy.</para></answer>
</qandaentry>
<qandaentry>
<question><para>What is a HOWTO?</para></question>
<answer><para>HOWTO's are usually step by step guides which describe in detail how to perform a specific task.For example, the Linux installation
<answer><para>HOWTO's are usually step by step guides which describe in detail how to perform a specific task. For example, the Linux Installation
HOWTO helps you install Linux on the system but it does not cover how to
set up a web server so that you can focus on a particular task.</para></answer>
</qandaentry>
<qandaentry>
<question><para>What is a man page?</para></question>
<answer><para>man (Manual) pages are the standard form of help available for many linux applications and utilities. They can be viewed using the man command. Many of the GNU utilities have more detailed form of help called info pages. They can be viewed with the info command.</para></answer>
<answer><para>man (Manual) pages are the standard form of help available for many linux applications and utilities. They can be viewed using the <command>man</command> command. Many of the GNU utilities have a more detailed form of help, called info pages. They can be viewed using the <command>info</command> command.</para></answer>
</qandaentry>
<qandaentry>
<question><para>What is a FAQ?</para></question>
<answer><para>A FAQ (Frequently Asked Questions) is a list of questions, usually available in a mailing list to avoid answering repetitive questions
<answer><para>A FAQ (Frequently Asked Questions) is a list of questions, usually available in mailing lists to avoid answering repetitive questions
asked by new users. For example, the Linux FAQ answers questions like, <quote>What is linux?</quote> and, <quote>How is Linux pronounced?</quote></para></answer>
</qandaentry>
<qandaentry>
<question><para>Where do I get all these documents?</para></question>
<answer><para>Most of the Linux distributions include the LDP documents so there is high chance that they are already available with you if you have installed Linux. The latest versions are available at <ulink url="http://www.tldp.org" />.</para></answer>
<answer><para>Most Linux distributions include the LDP documents, so there is a high chance they are already available for you if you've installed Linux. The latest versions are available at <ulink url="http://www.tldp.org" />.</para></answer>
</qandaentry>
<qandaentry>
<question><para>How are the documents licensed?</para></question>
<answer><para>LDP only has documents available under a free license like the GNU Free Documentation License which means that you are allowed to distribute, modify and do whatsoever you want to do as long as you do not change the copyright and licensing terms.</para></answer>
<answer><para>LDP only has documents available under a free license, like the GNU Free Documentation License, which means that you are allowed to distribute, modify and do whatsoever you want to do, as long as you do not change the copyright and licensing terms.</para></answer>
</qandaentry>
<qandaentry>
@ -101,15 +101,15 @@ asked by new users. For example, the Linux FAQ answers questions like, <quote>Wh
<qandaentry>
<question><para>Why should I contribute?</para></question>
<answer><para>Authors who want to help others by providing some documentation can do so through the LDP. The documents should under a free license such as the GNU free documentation license which ensures that everyone is benefited through your documents. Here are some of the major benefits when you contribute through the LDP:</para>
<answer><para>Authors who want to help others by providing some documentation can do so through the LDP. The documents should be under a free license, such as the GNU free documentation license, which ensures that everyone is benefited through your documents. Here are some of the major benefits when you contribute through the LDP:</para>
<itemizedlist>
<listitem><para>The LDP hosts the documents and ensures that it is available in all the formats including text, html and pdf so it can be viewed in a platform independant manner.</para></listitem>
<listitem><para>The LDP documents are usually available as part of many distributions and hence your documents reaches a wide community of Linux users.</para></listitem>
<listitem><para>Many of the Linux users who read your document may give you comments,suggestions or even provide additional content which ensures that the document is reliable and updated whenever neccessary.</para></listitem>
<listitem><para>The LDP hosts the document and ensures that it is available in all the formats, including text, html and pdf, so it may be viewed in a platform-independent manner.</para></listitem>
<listitem><para>The LDP documents are available as part of many distributions and hence your documents reach a wide community of Linux users.</para></listitem>
<listitem><para>Many of the Linux users who read your document may give you comments, suggestions or even provide additional content which ensures the document is reliable and updated whenever neccessary.</para></listitem>
<listitem><para>You may be providing some crucial help to users who come across the same issues that you solved on your own.</para></listitem>
<listitem><para>It is a form of contribution to the Linux and open source community which depends on volunteers for its growth.</para></listitem>
<listitem><para>You may also publish any of the LDP's documents including your own and get monitary benefits from the whole process.</para></listitem>
<listitem><para>You may also publish any of the LDP's documents, including your own, and get monetary benefits from the whole process.</para></listitem>
</itemizedlist>
</answer>
</qandaentry>
@ -135,7 +135,7 @@ whatever way they can.</para>
<qandaentry>
<question><para>In what format do I have to write the documentation?</para></question>
<answer><para>The source files for LDP documentation are created using SGML or XML markup, usually with either DocBook XML (v4.2 or v4.1.2) or SGML (v4.2, v4.1, and v3.x). There is an older standard called Linuxdoc SGML, which is not as robust. If you do not know any of these then you can write in plain text initially and submit the documentation, which can be converted to markup. Future updates would be done in either DocBook or Linuxdoc. SGML and XML markup are easy enough to learn if you are interested in maintaining the documentation over a long period. You may request help from volunteers in the mailing list to convert your documentation into DocBook for the first time, or refer to the Author's Guide for information on using these tools on your system.</para></answer>
<answer><para>The source files for LDP documentation are created using SGML or XML markup, usually with either DocBook XML (v4.2 or v4.1.2) or SGML (v4.2, v4.1, and v3.x). There is an older but acceptable standard called Linuxdoc SGML, which is not as robust. If you do not know any of these then you can write in plain text initially and submit the documentation, which can be converted to markup. Future updates would be done in either DocBook or Linuxdoc. SGML and XML markup are easy enough to learn if you are interested in maintaining the documentation over a long period. You may request help from volunteers in the mailing list to convert your documentation into DocBook for the first time, or refer to the Author's Guide for information on using these tools on your system.</para></answer>
</qandaentry>
<qandaentry>
@ -144,12 +144,11 @@ whatever way they can.</para>
</qandaentry>
<qandaentry>
<question><para>I have a important question which is unanswered here?</para></question>
<question><para>What if I have question which hasn't been answered here?</para></question>
<answer><para>
I might have missed it out. Please mail discuss@en.tldp.org. If its answered and you feel it should be included here, then send me a copy and I will add it it the next revision of this document.</para></answer>
I might have missed it. Please email discuss@en.tldp.org. If it's answered and you feel it should be included here, then send me a copy and I will add it to the next revision of this document.</para></answer>
</qandaentry>
</qandaset>
</article>