<div><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><br>Message: 2<br>Date: Wed, 9 May 2007 21:14:10 -0700<br>From: linux_learner <<a href="mailto:linux.learner@gmail.com">
linux.learner@gmail.com</a>><br>Subject: Re: smart Digest, Vol 21, Issue 2<br>To: <a href="mailto:smart@labix.org">smart@labix.org</a><br>Message-ID:<br>        <<a href="mailto:ae19ac280705092114h61af19c3vcb96f9dec9137b2d@mail.gmail.com">
ae19ac280705092114h61af19c3vcb96f9dec9137b2d@mail.gmail.com</a>><br>Content-Type: text/plain; charset="iso-8859-1"<br><br>Grant, I know your frustration. When I got involved, there was less<br>documentation than there is now. I have done the documentation for smart. I
<br>took what Gustavo did and expanded on it.<br><a href="http://labix.org/smart/howtoUnfortunately">http://labix.org/smart/howtoUnfortunately</a>, I don't know how to add<br>pictures well with the wiki Gustavo<br>uses. Before I started this, the smart config options were completely
<br>undocumented. <a href="http://labix.org/smart/config-options">http://labix.org/smart/config-options</a>  I think I drove Gustavo<br>and company nuts asking all the questions I did. I used this<br><a href="http://wiki.suselinuxsupport.de/wikka.php?wakka=HowtoSmartPackageManager">
http://wiki.suselinuxsupport.de/wikka.php?wakka=HowtoSmartPackageManager</a> as<br>my rough draft for <a href="http://labix.org/smart/howto">http://labix.org/smart/howto</a> but as you can see, it was a<br>lot easier for me to add screen shots to wikka.
<br><br>Now, personally, I think we should team up and work together. I have been<br>wanting to compile a collection of errors, so that users can more easily see<br>what an error is, what it means, and how to fix it. I have been wanting to
<br>add more examples, but I have been really sick lately. I am a newly<br>diagnosed diabetic and have been having seizures as well. This makes it<br>rather hard to keep going on the smart documentation. Also, everything is to
<br>scattered about. Like the errors. I'd have to scour the smart mailing lists,<br>and internet forums and other mailing lists for errors and bug reports<br>pertaining to smart. This is quite time consuming. Obviously, the smart
<br>mailing lists is the best place to start. But even that can be time<br>consuming.<br><br>Get back with me, and let me know what you think. I hope that you'll work<br>with me, and improve on the documentation.<br><br>
On 5/9/07, Grant McWilliams <<a href="mailto:grantmasterflash@gmail.com">grantmasterflash@gmail.com</a>> wrote:<br>><br>> I hadn't thought of using Python because I don't know it as well and this<br>> certain project needs to be
<br>> maintainable by the company I'm consulting for after I'm done and gone,<br>> hence the shell script.<br>><br>> I've spent quite a lot of time digging through what little docs there are<br>> concerning smart and I've decided
<br>> as soon as I'm done with my current project I'm writing exhaustive Smart<br>> documentation including examples<br>> because the frustration level has been high. There just aren't many<br>> examples on the net about this even though
<br>> it's getting used. I needed to install software across a secure channel<br>> which brought me to smart because of the<br>> mention in the doc about scp being a supported protocol. No examples, no<br>> more data, nothing. I did get it to work
<br>> and like I said I'll be writing documentation even if it doesn't get used<br>> officially because it needs to be done.<br>><br>> I don't have the time to give back in the form of coding but documentation
<br>> I can find time for so that's my gift, wanted or not. :-)<br>><br>> Grant<br>><br></blockquote></div><br>I think you've done a great job of getting this started. The links you've sent me have information in them that I missed as well as my colleagues that are working on the project too. The fact that we've missed them means there's more work to do. I agree that we 
<br>should work together. I'd like to have all documentation so easy to find and search through that a baby could do it. Also there is info in <br>the FAQ that is buried and a howto might bring it to the surface. Digging through a FAQ to try to figure out how do use an app (without a specific purpose) is a lot of work. Reading an explanation of all the features is a good format if you already know how the app works and you're just looking for a specific feature. What I think needs to be done is for the current docs to be cleaned up, made easier to find and howtos or a series of howtos created that give real world examples of how to use smart. I too gathered much of my information from the 
<br>Suse howtos. Thankfully Suse put out a crappy package manager thus making smart much more popular. Had that load of crap they use worked in 10.1 I may not have ever spent enough time with smart to switch to it. My current project uses it because it can install via a secure
<br>channel. I do think though that YUM is getting a lot of plugins made for it that makes it tempting to go back to. <br><br>Grant<br><br>