171 lines
14 KiB
HTML
171 lines
14 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy for Linux/x86 (vers 1st June 2003), see www.w3.org">
|
|
<title>The Linux Documentation Project Weekly News</title>
|
|
<meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.7">
|
|
<style type="text/css">
|
|
body {
|
|
background-color: #FFFFFF;
|
|
color: #000000;
|
|
}
|
|
:link { color: #0000FF }
|
|
:visited { color: #840084 }
|
|
:active { color: #0000FF }
|
|
p.c2 {font-weight: bold}
|
|
dt.c1 {font-weight: bold}
|
|
</style>
|
|
</head>
|
|
<body class="article">
|
|
<div class="ARTICLE">
|
|
<div class="TITLEPAGE">
|
|
<h1 class="title"><a name="AEN2"></a>The Linux Documentation Project Weekly News</h1>
|
|
<b>Issue Number :</b> 15<br>
|
|
<b>Publication Date :</b> 2004-04-14<br>
|
|
<hr></div>
|
|
<div class="TOC">
|
|
<dl>
|
|
<dt class="c1">Table of Contents</dt>
|
|
<dt>1. <a href="#new-review">Documents submitted for review</a></dt>
|
|
<dt>2. <a href="#new-proposed">New document proposals</a></dt>
|
|
<dt>3. <a href="#updated-docs">Updated HOWTOs, FAQs and Guides</a></dt>
|
|
<dt>4. <a href="#tldp-world-news">News in The LDP world</a></dt>
|
|
<dt>5. <a href="#tldp-discussions">Discussions on The LDP lists</a></dt>
|
|
<dt>6. <a href="#interview">Interview with Emma Jane Hogbin</a></dt>
|
|
<dt>7. <a href="#tldp-contribute">HOWTO contribute to The LDP</a></dt>
|
|
</dl>
|
|
</div>
|
|
<div class="sect1">
|
|
<h1 class="sect1"><a name="new-review"></a>1. Documents submitted for review</h1>
|
|
<ul>
|
|
<li><span class="rss:item">Emma Jane was still not happy with the Author Guide and after some discussion submitted a <a href="http://cvsview.tldp.org/index.cgi/LDP/guide/docbook/LDP-Author-Guide/"
|
|
target="_top">new update</a>, merging the contribution section into The LDP publishing process section.</span></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="new-proposed"></a>2. New document proposals</h1>
|
|
<ul>
|
|
<li><span class="rss:item">Nico Schottelius wrote a <a href="http://lists.tldp.org/index.cgi?5:mss:9046:200404:gkahgfjmoglaokcaaepk" target="_top">mini-HOWTO about Cryptoloop partial security</a> and
|
|
awaits your comments. The document explains what Cryptoloop is, what it is used for and why it is only partially secure. A section also discusses solutions to the problem.</span></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="updated-docs"></a>3. Updated HOWTOs, FAQs and Guides</h1>
|
|
<ul>
|
|
<li><span class="rss:item">David Hinds submitted the v2.118 of his <a href="http://tldp.org/HOWTO/PCMCIA-HOWTO.html" target="_top">Linux PCMCIA HOWTO</a>. This version features updated lists of
|
|
supported hardware, updated program version numbers of the discussed software and a whole new section about the kernel PCMCIA support in 2.4 kernels and higher.</span></li>
|
|
<li><span class="rss:item">Christine Lorenz submitted v2.3.0 of the <a href="http://tldp.org/LDP/EVMSUG/html/index.html" target="_top">EVMS User Guide</a>. She is co-author of this document with Joy
|
|
Goodreau and Kylie Smith.</span></li>
|
|
<li><span class="rss:item">Walt Penningtons <a href="http://tldp.org/HOWTO/Medicine-HOWTO/" target="_top">Linux Medicine-HOWTO</a> is now at v2.3. This new release has few minor updates.</span></li>
|
|
</ul>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="tldp-world-news"></a>4. News in The LDP world</h1>
|
|
<ul>
|
|
<li><span class="rss:item">The LDP Feedback<br></span>
|
|
<p><span class="rss:item">It has been close to an year since The LDP weekly news was re-started. The <a href="http://tldp.org/ldpwn/latest.html" target="_top">latest LDPWN</a> is available on the
|
|
web, mailed to the <tt class="email"><<a href="mailto:news@en.tldp.org">news@en.tldp.org</a>></tt> mailing list and several important news sources. There is also an <a href=
|
|
"http://www.karakas-online.de/myServices/rssify.php?url=http://tldp.org/ldpwn/latest.html" target="_top">RSS feed</a> in case you would like to track us with your favorite aggregator. We take this
|
|
opportunity to request you for comments and suggestions for improvement. Please send in your feedback to <tt class="email"><<a href=
|
|
"mailto:feedback@en.tldp.org">feedback@en.tldp.org</a>></tt></span></p>
|
|
</li>
|
|
<li><span class="rss:item">IRC: Freenode Server #tldp room<br></span>
|
|
<p><span class="rss:item">The Freenode servers we have a #tldp room for IRC. Connect to one of the servers at <a href="http://freenode.net/irc_servers.shtml" target=
|
|
"_top">http://freenode.net/irc_servers.shtml</a> and join #tldp.</span></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="tldp-discussions"></a>5. Discussions on The LDP lists</h1>
|
|
<ul>
|
|
<li><span class="rss:item">Document Licensing Discussion<br></span>
|
|
<p><span class="rss:item">Rahul Sundaram was <a href="http://lists.tldp.org/index.cgi?1:mss:6964:200404:ihpahginmljdgbhooeje" target="_top">unhappy</a> that he might be volunteering his work to
|
|
document authors that restrict their documentation with a non-free license and indicated what he thought would be acceptable licenses. Rick Moen <a href=
|
|
"http://lists.tldp.org/index.cgi?1:mss:6965:200404:pkdleajpekbbaookkgbd" target="_top">described</a> what those licenses were and their problems (like the <a href=
|
|
"http://people.debian.org/~srivasta/Position_Statement.xhtml" target="_top">DFSG-freeness of GNU FDL 1.2</a>). Rodolfo J. Paiz was of the <a href=
|
|
"http://lists.tldp.org/index.cgi?1:mss:6968:200404:ehngfbpnepphojhokgdn" target="_top">opinion</a> that license of a document is an individual choice and volunteering for a work with a license that
|
|
one does not like is not obligatory. David Lawyer and Greg Ferguson <a href="http://lists.tldp.org/index.cgi?1:mss:6979:200404:claiepedajakajhoajgg" target="_top">explained</a> the <a href=
|
|
"http://lists.tldp.org/index.cgi?1:mss:6982:200404:ifhbolfhjihbhnkaanhb" target="_top">recommendations</a> of The LDP.</span></p>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="interview"></a>6. Interview with Emma Jane Hogbin</h1>
|
|
<div class="figure"><a name="AEN61"></a>
|
|
<p class="c2">Figure 1. Emma Jane Hogbin</p>
|
|
<div class="mediaobject">
|
|
<p><img src="emma.jpg"></p>
|
|
</div>
|
|
</div>
|
|
<ul>
|
|
<li><span class="rss:item">Emma Jane Hogbin, probably the most talkative TLDP volunteer, was very enthusiastic when we asked her if she would grant us an interview. <a href=
|
|
"http://tldp.org/ldpwn/20040414.html#interview" target="_top">Get to know Emma Jane:</a></span></li>
|
|
</ul>
|
|
<p><em>Q: The classical question first: how, why and when did you get involved?</em></p>
|
|
<p>A: Well I've always been a bit of a docco [Editor's Note: that's a documentation maniac]. Unlike many of my other technically oriented friends, I actually write notes when I'm trying to install
|
|
software. And then I go back and check my notes to make sure things are correctly documented. It makes life a lot easier if I ever need to install that software again. Just to give an example: In the
|
|
first year that I was running Debian Linux on my laptop I had to re-install the system about half a dozen times. (Yes, I'm as shocked as you are.) Each time my notes improved and I got a little
|
|
faster at performing each of the required steps.</p>
|
|
<p>The first publicly available documentation I wrote for a specific application was for <a href="http://www.htdig.org" target="_top">ht://dig</a> (a great little search engine). The document was
|
|
very well received by my client at the time, and by the ht://dig community. Although my documentation had always been appreciated at work, this was the first time I'd received recognition from a
|
|
community of users.</p>
|
|
<p>My first document accepted to the LDP was the <a href="http://www.ibiblio.org/mdw/HOWTO/ACPI-HOWTO/index.html" target="_top">ACPI HOWTO</a>. Originally, it was just notes on the installation
|
|
process, that I made for myself. These I submitted to various mailing lists to confirm their accuracy. I got lots of good feedback and Sebastian Henschel asked me to publish them on-line for the
|
|
<a href="http://acpi.sourceforge.net/" target="_top">ACPI4Linux team</a>. Werner Heuser suggested I submit the document to The LDP. Tabatha did my language review and started sending me really polite
|
|
emails suggesting that maybe I'd like to be a technical reviewer. The next thing I knew I'd volunteered to re-write the Author Guide (a total of about nine months work) and suddenly I was a full
|
|
fledged technical and meta data reviewer.</p>
|
|
<p>My original ACPI HOWTO now needs a major revamp for the 2.6 kernels, and I've been gearing up to work on that. Ariel Glenn will be helping me with the re-write (a process I'm actually looking
|
|
forward to now).</p>
|
|
<p><em>Q: I took the liberty of going through your CV. As far as your employment is concerned, you seem to do fairly well and in accordance to the subjects you studied while at the university. But
|
|
then for TLDP I see you reviewing the USB Flash Memory HOWTO and the BLFS document, and authoring the ACPI HOWTO. How did you grow an interest for these?</em></p>
|
|
<p>A: At this point I'm doing two types of reviews: metadata and technical. For the technical reviews I need to know something about the topic that I'm reviewing. I currently have a USB key chain and
|
|
a USB camera, so it was a good match for me to review Niko's <a href="http://www.ibiblio.org/mdw/HOWTO/Flash-Memory-HOWTO/index.html" target="_top">USB Flash Memory HOWTO</a>.</p>
|
|
<p>The meta data reviews look at a different set of things, specifically the markup of the document (does the DocBook/LinuxDoc validate?) and the license the document is released under. There's a bit
|
|
more to it than that, but those are the two things that take the most time on a meta data review. When I'm doing a meta data review I tend to scan the document for technical/language inaccuracies as
|
|
well, but I don't spend a lot of time on it.</p>
|
|
<p>Then I have a third set of responsibilities: authoring documents. I'm currently an author on three documents at The LDP: ACPI HOWTO, <a href="http://tldp.org/LDP/LDP-Author-Guide/html/index.html"
|
|
target="_top">The Author Guide</a> and the <a href="http://www.tldp.org/HOWTO/LDP-Reviewer-HOWTO/" target="_top">Reviewer HOWTO</a>. The first (ACPI HOWTO) was simply a document that I wrote from my
|
|
own notes on a specific problem that I had to solve. The second two documents are more "process" documents for The LDP. There are a lot of volunteers at The LDP, many of whom perform critical roles
|
|
in the publication of documents. I've been working on getting some of these processes documented so that if a volunteer ever wanted help, or decided to retire, there would be instructions on how to
|
|
perform that volunteer's tasks.</p>
|
|
<p><em>Q: Did you ever have difficulties or encounter restrictions, being a woman at TLDP? And the eternal question: What should we do to get more female volunteers? What should men do to get more
|
|
women to join this and other Linux projects?</em></p>
|
|
<p>A: The only restriction I've found is that I get to do more work! The men on the list are good at discussing the overall direction of The LDP while the women seem to be better at processing new
|
|
documents for their collection into the LDP (and removing old/out of date documents). When it comes to processing documents I work primarily with three women and Greg Ferguson--that's not to say that
|
|
there aren't any male volunteers! They just aren't the ones that I do the most work with for the processing of documents.</p>
|
|
<p>Then I look at the work I do on the overall picture and it's mostly men (and two women). Saqib Ali and David Horton have helped me a great deal with the tool and document transformations. Greg, as
|
|
I mentioned above, is responsible for publishing documents. Stein Gjoen and I have had many interesting conversations about library-friendly document storage and meta data. Most of the licensing
|
|
discussions are headed up by the men on our team.</p>
|
|
<p>As much as I would like to say that it's the men who need to do something to get more women involved, I think it's really up to the women. Yes, there are some male bozos out there, but there are
|
|
some female ones too. Generally my advice is this: when the bozos behave badly, let them know what is wrong about their behaviour; then thank them for their help when they are being good. If a group
|
|
has an overwhelming number of bozos, find a new group. There is not a single Linux group that I've quit because of men behaving badly.</p>
|
|
<p>So how do we get more women involved? Good question. I don't have a lot of tech-oriented female friends. And those who are tech-oriented are too busy working to consider switching operating
|
|
systems. It's a long, slow process, but I think as sophistication of Linux desktop applications grows and then surpasses the applications available on Windows/Macs we will see more women involved
|
|
with Linux. Certainly I came to Unix/Linux fairly late. I was a Machead growing up, then switched to Windows for university. I tried Linux in 2000, but the applications I needed weren't stable enough
|
|
for me at the time. I tried again in 2002 and have been here ever since.</p>
|
|
<p><em>Q: What could TLDP be doing better, according to you?</em></p>
|
|
<p>A: I know how much work is involved because I am a reviewer, but... I would like to see the entire collection reviewed. I would like to have the volunteer power to review every document on its one
|
|
year anniversary. At that time the document would be either kept in the collection <span class="QUOTE">"as is"</span>, removed from the collection, or kept with certain conditions (for example my
|
|
ACPI HOWTO needs to contain information about the 2.6 series kernels). The review date would be based on the document's anniversary, not based on the <span class="QUOTE">"last updated"</span>
|
|
date.</p>
|
|
<p>That and having mugs for sale. The <a href="http://www.hackerthreads.com/?page=shop/browse&category_id=ae255697973840ae34ac3dcd028e55ce" target="_top">t-shirts</a> are nice, but what I really
|
|
want is a mug.</p>
|
|
</div>
|
|
<div class="sect1">
|
|
<hr>
|
|
<h1 class="sect1"><a name="tldp-contribute"></a>7. HOWTO contribute to The LDP</h1>
|
|
<p><a href="http://www.tldp.org/" target="_top">The Linux Documentation Project</a> (TLDP) is working on developing free, high quality documentation for the GNU/Linux operating system. If you want to
|
|
help TLDP, consider joining <tt class="email"><<a href="mailto:discuss-subscribe@en.tldp.org">discuss-subscribe@en.tldp.org</a>></tt>.</p>
|
|
<p>Help us create this newsletter. We need volunteers who follow the community (mailing lists, newsgroups, web channels) and report events related to free software documentation. Write to us at
|
|
<tt class="email"><<a href="mailto:feedback@en.tldp.org">feedback@en.tldp.org</a>></tt>.</p>
|
|
<p>The LDP Weekly News is compiled and edited by Machtelt Garrels and Y Giridhar Appaji Nag with help from several other people.</p>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|