Date: Tue, 7 Feb 2006 18:57:36 +0000 (UTC) From: Daniel Gerzo <danger@rulez.sk> To: FreeBSD-gnats-submit@FreeBSD.org Subject: www/92986: [patch] some modification and updates for projects/newbies.html Message-ID: <20060207185736.60C12483E5D@tomas.elvandar.org> Resent-Message-ID: <200602071900.k17J0IX7007817@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 92986 >Category: www >Synopsis: [patch] some modification and updates for projects/newbies.html >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-www >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Feb 07 19:00:18 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Daniel Gerzo >Release: FreeBSD 6.0-RELEASE i386 >Organization: rulez.sk >Environment: System: FreeBSD 6.0-RELEASE #3: Fri Nov 4 21:58:23 CET 2005 i386 >Description: I've added some more content, modified a few lines and fixed some links, and removed smilies ":-)". Built version is available at: http://www.sk.freebsd.org/projects/newbies.new.html >How-To-Repeat: http://www.freebsd.org/projects/newbies.html >Fix: --- newbies.diff begins here --- --- /usr/home/danger/www/en/projects/newbies.sgml.orig Tue Feb 7 18:00:38 2006 +++ /usr/home/danger/www/en/projects/newbies.sgml Tue Feb 7 18:47:50 2006 @@ -4,6 +4,8 @@ <!ENTITY title 'Resources for Newbies'> <!ENTITY % navincludes SYSTEM "../includes.navdocs.sgml"> %navincludes; <!ENTITY % includes SYSTEM "../includes.sgml"> %includes; +<!ENTITY url.articles "&base;/doc/en_US.ISO8859-1/articles"> +<!ENTITY url.books "&base;/doc/en_US.ISO8859-1/books"> ]> <html> @@ -30,13 +32,12 @@ <ul> <li><p><a href="&base;/search/search.html">Search</a> the Handbook and FAQ, the - whole web site, or the archives of the FreeBSD-Questions mailing - list.</p></li> + whole web site, or the FreeBSD mailing list archives.</p></li> <li><p>The <a href="&base;/docs.html">Documentation</a> page has links to the Handbook and FAQ, tutorials, information about contributing to the Documentation Project, documents in languages other than English, - and much more.</p></li> + online manual pages, and much more.</p></li> <li><p>The <a href="&base;/support.html">Support</a> page contains a wealth of information about FreeBSD, including mailing lists, user groups, web @@ -47,11 +48,15 @@ <h2><a name="fbsd">Learning about FreeBSD</a></H2> <ul> - <li><p>If you have not yet installed, look for the + <li><p>If you have not yet installed, and have not yet decided + which version of FreeBSD is the best for your needs, the <a + href="&url.articles;/version-guide/index.html">Choosing + the FreeBSD Version That Is Right For You</a> article is meant + to help you to decide. You should most probably look for the <a href="&u.rel.announce;">latest mainstream release</a>. (See the Handbook for why you should <strong>not</strong> be tempted by any of the other branches.) Before you begin, carefully read the - <a href="&base;/doc/en_US.ISO8859-1/books/handbook/install.html">installation instructions</a>, + <a href="&url.books;/handbook/install.html">installation instructions</a>, as well as each one of the *.TXT files in the FTP directory or on the installation CD. They are there because they contain information that you will need. Also pick up the latest @@ -63,7 +68,7 @@ instructions</a> for a previous version are still available before you begin. That should make the whole process a lot clearer.</p></li> - <li><p>A number of <a href="../docs.html#articles">short + <li><p>A number of <a href="&base;/docs/books.html#ARTICLES">short articles and tutorials</a> are available. The short tutorial, <a href="http://andrsn.stanford.edu/FreeBSD/">For People New to Both FreeBSD and Unix</a>, is popular with absolute @@ -75,7 +80,7 @@ <li><p>The first thing many people need to set up is ppp, and there is a lot of documentation to help. You might start with at least those parts of the - <a href="&base;/doc/en_US.ISO8859-1/books/handbook/index.html">Handbook</a> + <a href="&url.books;/handbook/index.html">Handbook</a> that are relevant to your needs, and explore the <a href="http://www.awfulhak.org/ppp.html">ppp page</a> for links to the other valuable information and the latest updates.</p></li> @@ -87,8 +92,8 @@ everything you need to know to set up and run a FreeBSD system. You also get to understand what you are doing and why.</p></li> - <li><p>The <a href="&base;/doc/en_US.ISO8859-1/books/handbook/index.html">FreeBSD Handbook</a> and <a - href="&base;/doc/en_US.ISO8859-1/books/faq/index.html">Frequently Asked Questions (FAQ)</a> are the + <li><p>The <a href="&url.books;/handbook/index.html">FreeBSD Handbook</a> and <a + href="&url.books;/faq/index.html">Frequently Asked Questions (FAQ)</a> are the main documents for FreeBSD. Essential reading, they contain a lot of material for newbies as well as some pretty advanced stuff. Do not worry if you are unable to understand the advanced sections. The handbook @@ -127,6 +132,12 @@ easier.</p> <ul> + <li><p>The <a href="&url.books;/handbook/basics.html">&unix; + Basics</a> chapter of the FreeBSD Handbook covers the basic + commands and functionality of FreeBSD operating system. Most + of information provided in this document is also relevant for + any other &unix;-like operating system.</p></li> + <li><p>There are many easy books, such as the "Dummies" guides, in any large book shop. If you want something really easy, take a look at what is available and pick one that seems to speak your language. @@ -200,9 +211,9 @@ <li><p>For basic information about installing, configuring and using the X Window System, three of the books mentioned above have sections dealing with X at beginner level: - <a href="&base;/doc/en_US.ISO8859-1/books/handbook/index.html">The FreeBSD Handbook</a>, - <a href="#cfbsd">The Complete FreeBSD</a>, and - <a href="#ufti">UNIX for the Impatient</a>.</p></li> + <a href="&url.books;/handbook/x11.html">The X Window System</a> chapter + of the FreeBSD Handbook, <a href="#cfbsd">The Complete FreeBSD</a>, + and <a href="#ufti">UNIX for the Impatient</a>.</p></li> <li><p>Before you can get X running exactly the way you like, you will need to choose a window manager. @@ -220,7 +231,7 @@ <p>Everyone has something to contribute to the FreeBSD community, even newbies! Some are busy working with the new advocacy group and some have become involved with the - <a href="../docproj/docproj.html">Documentation Project</a> as reviewers. + <a href="&base;/docproj/docproj.html">Documentation Project</a> as reviewers. Other FreeBSD newbies might have particular skills and experiences to share, either computer related or not, or just want to meet new newbies and make them feel welcome. There are always people around @@ -230,7 +241,7 @@ chatting on the phone or across a pizza with someone who has the same interests, enjoys similar accomplishments, and faces the same challenges. If you do not have many friends who use FreeBSD, - consider using your old FreeBSD CDs to create some more :-)</p> + consider using your old FreeBSD CDs to create some more.</p> <p><a href="&base;/usergroups.html">User groups</a> are good places to meet other FreeBSD users. If there is no one nearby, @@ -238,14 +249,8 @@ <p>Before talking to real humans about your new skills, you might want to check the <a - href="http://catb.org/~esr/jargon/html/index.html">Jargon File</a> :-)</p> + href="http://catb.org/~esr/jargon/html/index.html">Jargon File</a>.</p> - <p>Online, we have the - <a - href="http://lists.FreeBSD.org/mailman/listinfo/freebsd-questions">FreeBSD-questions</a>; - mailing list for questions and discussions about using - FreeBSD.</p> - &footer; </body> </html> --- newbies.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060207185736.60C12483E5D>