<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Yet Another Linux Blog &#187; documentation</title>
	<atom:link href="http://linux-blog.org/tag/documentation/feed/" rel="self" type="application/rss+xml" />
	<link>http://linux-blog.org</link>
	<description>Open Source, Open Blog</description>
	<lastBuildDate>Thu, 22 Jul 2010 03:57:32 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0</generator>
		<item>
		<title>The Foresight Linux Search Engine</title>
		<link>http://linux-blog.org/the-foresight-linux-search-engine/</link>
		<comments>http://linux-blog.org/the-foresight-linux-search-engine/#comments</comments>
		<pubDate>Fri, 06 Feb 2009 17:08:58 +0000</pubDate>
		<dc:creator>devnet</dc:creator>
				<category><![CDATA[Distros]]></category>
		<category><![CDATA[Misc]]></category>
		<category><![CDATA[documentation]]></category>
		<category><![CDATA[foresight]]></category>
		<category><![CDATA[linux]]></category>
		<category><![CDATA[search]]></category>

		<guid isPermaLink="false">http://linux-blog.org/?p=890</guid>
		<description><![CDATA[If you&#8217;re a Foresight Linux user, there are many resources you have at your disposal for documentation.  First and foremost, you have the excellent guide shipped by default in Foresight accessible in the menu&#8230;but there are other resources you can search for a resolution to your problems.  The Foresight Wiki and Foresight Forum are other [...]


Related posts:<ol><li><a href='http://linux-blog.org/clarification-on-foresight-and-fedora/' rel='bookmark' title='Permanent Link: Clarification on Foresight and Fedora'>Clarification on Foresight and Fedora</a> <small>I previously wrote about a possible &#8220;rebasing&#8221; of Foresight Linux...</small></li>
<li><a href='http://linux-blog.org/foresight-and-fedora-clarkconnect-becomes-clearos/' rel='bookmark' title='Permanent Link: Foresight and Fedora, ClarkConnect Becomes ClearOS'>Foresight and Fedora, ClarkConnect Becomes ClearOS</a> <small>Foresight and Fedora (aka &#8220;boots, a fedora remix&#8221;) Last week...</small></li>
<li><a href='http://linux-blog.org/foresight-rpath-livecd-and-unity-linux/' rel='bookmark' title='Permanent Link: Foresight, rPath, LiveCD, and Unity Linux'>Foresight, rPath, LiveCD, and Unity Linux</a> <small>Most, if not all, top distributions of Linux ship a...</small></li>
</ol>

Related posts brought to you by <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>If you&#8217;re a <a href="http://foresightlinux.org">Foresight Linux</a> user, there are many resources you have at your disposal for documentation.  First and foremost, you have the excellent guide shipped by default in Foresight accessible in the menu&#8230;but there are other resources you can search for a resolution to your problems.  The <a href="http://wiki.foresightlinux.org" target="_blank">Foresight Wiki </a>and <a href="http://forum.foresightlinux.org" target="_blank">Foresight Forum</a> are other areas that can be searched as well as the <a href="http://issues.foresightlinux.org" target="_blank">Foresight Issue Tracking System</a> (FITS).  Since Foresight is rPath Linux based, you also have the <a href="http://lists.rpath.com" target="_blank">rPath mailing lists</a>, the <a href="http://wiki.rpath.com/wiki" target="_blank">rPath wiki</a> and <a href="http://issues.rpath.com" target="_blank">rPath Issue Tracking System</a> (rITS).  There is also <a href="http://planet.conary.com" target="_blank">Planet Conary</a> and <a href="http://planet.foresightlinux.org" target="_blank">Planet Foresight</a>.  With all of these resources, I found that I was jumping back and forth quite a bit while searching for information.  There isn&#8217;t anything wrong with that, but it isn&#8217;t efficient.</p>
<p>Taking this into consideration, last year I created a <a href="http://bit.ly/foresight-search-engine" target="_blank">Foresight Linux search engine</a>.  (You can bookmark this at http://bit.ly/foresight-search-engine because the Google url is quite long)</p>
<p>This search engine is Google powered and searches the following locations for you:</p>
<ol>
<li><span style="color: #008000;">http://wiki.rpath.com/wiki/*</span></li>
<li><span style="color: #008000;">http://foresightlinux.org/*</span></li>
<li><span style="color: #008000;">http://wiki.foresightlinux.org/*</span></li>
<li><span style="color: #008000;">http://issues.foresightlinux.org/*</span></li>
<li><span style="color: #008000;">http://planet.foresightlinux.org/*</span></li>
<li><span style="color: #008000;">http://planet.conary.com/*</span></li>
<li><span style="color: #008000;">http://lists.rpath.com/*</span></li>
<li><span style="color: #008000;">http://forum.foresightlinux.org<br />
</span></li>
</ol>
<p>The interface is a single search blank that returns results from the aforementioned 8 sites.  Google indexes those domains and searches through them for you, making it much easier to find what you&#8217;re looking for.</p>
<p>If you&#8217;d like to give it a try, you can visit the link above.  On the <a href="http://bit.ly/foresight-search-engine" target="_blank">front page of the search engine</a>, you can get code to <a href="http://gmodules.com/ig/creator?hl=en&amp;url=http%3A%2F%2Fwww.google.com%2Fcoop%2Fapi%2F013952018156024837389%2Fcse%2Fxrdon5kyyvg%2Fgadget">embed this search engine on any web page</a> or <a href="http://fusion.google.com/add?hl=en&amp;moduleurl=http%3A%2F%2Fwww.google.com%2Fcoop%2Fapi%2F013952018156024837389%2Fcse%2Fxrdon5kyyvg%2Fgadget">add it to your google homepage</a> as well.  Hopefully, this search eninge will come in handy for Foresight Linux users.</p>


<p>Related posts:<ol><li><a href='http://linux-blog.org/clarification-on-foresight-and-fedora/' rel='bookmark' title='Permanent Link: Clarification on Foresight and Fedora'>Clarification on Foresight and Fedora</a> <small>I previously wrote about a possible &#8220;rebasing&#8221; of Foresight Linux...</small></li>
<li><a href='http://linux-blog.org/foresight-and-fedora-clarkconnect-becomes-clearos/' rel='bookmark' title='Permanent Link: Foresight and Fedora, ClarkConnect Becomes ClearOS'>Foresight and Fedora, ClarkConnect Becomes ClearOS</a> <small>Foresight and Fedora (aka &#8220;boots, a fedora remix&#8221;) Last week...</small></li>
<li><a href='http://linux-blog.org/foresight-rpath-livecd-and-unity-linux/' rel='bookmark' title='Permanent Link: Foresight, rPath, LiveCD, and Unity Linux'>Foresight, rPath, LiveCD, and Unity Linux</a> <small>Most, if not all, top distributions of Linux ship a...</small></li>
</ol></p>
<p>Related posts brought to you by <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p><p><a href="http://linux-blog.org/the-foresight-linux-search-engine/" rel="bookmark">The Foresight Linux Search Engine</a> originally appeared on <a href="http://linux-blog.org">Yet Another Linux Blog</a> on February 6, 2009.</p>
]]></content:encoded>
			<wfw:commentRss>http://linux-blog.org/the-foresight-linux-search-engine/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>rPath Documentation Status Update</title>
		<link>http://linux-blog.org/rpath-documentation-status-update/</link>
		<comments>http://linux-blog.org/rpath-documentation-status-update/#comments</comments>
		<pubDate>Thu, 12 Jun 2008 11:01:00 +0000</pubDate>
		<dc:creator>devnet</dc:creator>
				<category><![CDATA[Linux@Work]]></category>
		<category><![CDATA[conary]]></category>
		<category><![CDATA[docbook]]></category>
		<category><![CDATA[documentation]]></category>
		<category><![CDATA[rmake]]></category>
		<category><![CDATA[rpath]]></category>

		<guid isPermaLink="false">http://linux-blog.org/word/rpath-documentation-status-update/</guid>
		<description><![CDATA[There are many changes on the horizon for rPath Documentation. One of the things that team docs here has known for a while is that the rPath wiki is a fantastic tool to leverage for documentation. It&#8217;s quick. It&#8217;s easy. It allows engineers to contribute directly to the wiki. It allows community members to contribute [...]


Related posts:<ol><li><a href='http://linux-blog.org/clarification-on-foresight-and-fedora/' rel='bookmark' title='Permanent Link: Clarification on Foresight and Fedora'>Clarification on Foresight and Fedora</a> <small>I previously wrote about a possible &#8220;rebasing&#8221; of Foresight Linux...</small></li>
<li><a href='http://linux-blog.org/foresight-rpath-livecd-and-unity-linux/' rel='bookmark' title='Permanent Link: Foresight, rPath, LiveCD, and Unity Linux'>Foresight, rPath, LiveCD, and Unity Linux</a> <small>Most, if not all, top distributions of Linux ship a...</small></li>
</ol>

Related posts brought to you by <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.]]></description>
			<content:encoded><![CDATA[<p>There are many changes on the horizon for rPath Documentation.</p>
<p>One of the things that team docs here has known for a while is that the rPath wiki is a fantastic tool to leverage for documentation.  It&#8217;s quick.  It&#8217;s easy.  It allows engineers to contribute directly to the wiki.  It allows community members to contribute to to the wiki.</p>
<p>We&#8217;ve also known for a while that this tool has a major caveat&#8230;and that is that versioned documentation is costly.  For example, if we had say version 1.0 documentation of a project at wiki.rpath.com/v1/productname and version 2.0 came out, we&#8217;d have to maintain 2 separate documents with the same information in two different URI&#8217;s and 2 different name spaces.  With each addition of namespace and project version, updates would be more costly and time consuming.</p>
<p>It&#8217;s also a bad thing that a user can search the wiki&#8230;and have the possibility of getting results from versions that they are not using&#8230;possibly information and behavior of products that no longer applies.</p>
<p><span id="more-218"></span></p>
<p>So how do we plan on combating this? There are a couple of phases of plans that we&#8217;ve been thinking about. The first of these is to move all product related guides (Administrative, User) offline into docbook format (pdf, html). We&#8217;ve begun testing this idea already.</p>
<p>This buys us the ability to keep versioned documentation separate from the wiki which empowers customers by giving them only the documentation they need and not requiring them to wade through search results to get the documentation they need.</p>
<p>This also is good for the community. Why? Because community docs will remain on the wiki and product documentation will be separated from it <img src='http://linux-blog.org/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' />  This means that documentation on using open source tools like Conary and working with rBuilder Online will be separate from rPath products making things easier to find and easier to contribute to.</p>
<p>The next phase of the plan after separating product specific documentation is to provide a central repository for those offline docs. This is further down the road and will only take place if product documentation has been moved offline. When this phase hits, there will be a handy website that serves as a central repository for all documentation, whether product based or community based. Currently, there are no plans to move community documentation from the wiki (Conary, rBuilder Online, rMake).</p>
<p>So, those are some of the updates we&#8217;ve been talking about doing. Nothing is set in concrete but we&#8217;re continuing to stay busy by keeping the information readily available to both community and customer <img src='http://linux-blog.org/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>


<p>Related posts:<ol><li><a href='http://linux-blog.org/clarification-on-foresight-and-fedora/' rel='bookmark' title='Permanent Link: Clarification on Foresight and Fedora'>Clarification on Foresight and Fedora</a> <small>I previously wrote about a possible &#8220;rebasing&#8221; of Foresight Linux...</small></li>
<li><a href='http://linux-blog.org/foresight-rpath-livecd-and-unity-linux/' rel='bookmark' title='Permanent Link: Foresight, rPath, LiveCD, and Unity Linux'>Foresight, rPath, LiveCD, and Unity Linux</a> <small>Most, if not all, top distributions of Linux ship a...</small></li>
</ol></p>
<p>Related posts brought to you by <a href='http://mitcho.com/code/yarpp/'>Yet Another Related Posts Plugin</a>.</p><p><a href="http://linux-blog.org/rpath-documentation-status-update/" rel="bookmark">rPath Documentation Status Update</a> originally appeared on <a href="http://linux-blog.org">Yet Another Linux Blog</a> on June 12, 2008.</p>
]]></content:encoded>
			<wfw:commentRss>http://linux-blog.org/rpath-documentation-status-update/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
