Wiki editing of guides

pablogott's picture
Forums: 

Many times I have come across little mistakes or sections that weren't clear to me initially, and I had to check around to find the answer. I would love to be able to go back to the guide and edit them. Is there any chance we could get some wiki or equivalent functionality here?

aaron's picture

I would like that too. But I need to do two things:

- Be able to authenticate users against our Geeklog database
- Use the Leopard Server wiki (try it once, you'll never look back)

I haven't yet figured our how to do both at the same time...

Aaron Freimark
CEO, GroundControl

pablogott's picture

that would be awesome. I was thinking it would be very helpful if we had a section of common log entries that we could post and explain what they mean, or what to do about them, something a wiki would be great for.

If I can help out in anyway, let me know.

aaron's picture

Um, [url]http://wiki.xsanity.com/url, anyone?

You'll need to E-mail me for an account. I'm standing by.

Aaron Freimark
CEO, GroundControl

pablogott's picture

Thanks aaron for setting it up. I have really benefited from the xsanity community, I appreciate all of the people who contribute here.

I know I'm not the most knowledgeable Xsan administrator here, as you can probably tell by some of my other posts, so I am going to concentrate on getting the easy stuff out of the way, and hope some of the more seasoned members will fill in the blanks.

I would like to move the articles that have been written for the site to the wiki, but I'm not sure how the authors would feel about that, and how it would fit into the coherency of the wiki. I have found them tremendously useful but I think novice users could benefit from more detailed information by linking to other relevant articles.

What are your thoughts on that?

Should we try to make a strategy for the wiki?

I strongly encourage you to ask Aaron for a wiki account. We can all benefit from this, and if we put some real effort in it, it will encourage even more people to run xsan. I know of 2 production houses in San Francisco that should be running an xsan, but are afraid to jump in. For all of you who are in xsan sales and installation, the more people who are willing to run it, the better!

aaron's picture

Moving so we are mostly wiki-based is interesting, but I have worries, too. Let's keep discussing.

Pablogott makes some good points. We have some fantastic content, but it isn't easily found on the site. And some of it has gone stale. The new wiki also has a blog that is well-integrated into the wiki. That's good too.

BUT, the wiki I chose (Leopard Server's wiki) is a brand new web application. It could erase our content after the 27th user, or be prone to spam, or give entry to hackers who zombie my server (hey, [url=http://www.xsanity.com/article.php/20060326082534560]it's happened before/url). We don't know yet, and very few people seem to be using the software as publicly as we are.

Also, and more worrisome to me, is the difference between a closely-edited blog and a wiki. The way we work now, when someone posts a well-researched and well-written "How To" to the main site, they get credit. Visitors from Google three years from now will still reference Jason's [url=http://www.xsanity.com/article.php/20060830182641771]ACL introduction/url or Matt's recent [url=http://www.xsanity.com/article.php?story=20071125064731410]renaming tutorial/url. Wikis, I believe, tend to aggregate and therefor anonymize authorship. [b]Would our authors have written so precisely, knowing that we encourage others to change their handiwork?/b How important are these sorts of articles to all of you, anyway?

It's only fair that I answer my own question. After all, I've posted how-tos a few times. I think I would continue posting, but perhaps with a bit less detail and research. I could always edit my own stuff later, right? So I still would have written the piece on [url=http://www.xsanity.com/article.php?story=20060920201633799]Reverse DNS/url, but as something less linear, split over several wiki topics, and perhaps still unfinished.

On the other hand, we've only had [url=http://www.xsanity.com/search.php?query=&keyType=phrase&datestart=2006-1... or eight blog authors in the last year/url, besides me. Maybe -- probably -- participation of this kind would increase. And as Xsan reaches more people -- as Apple is clearly pushing with Leopard and Xsan 2 -- perhaps we should welcome a more accessible and open Xsanity.

Aaron Freimark
CEO, GroundControl

Tim Burton's picture

I personally like the article format its very clean and the search function works well. Also I think a lot of people are introduced to Xsanity via searching for solutions. For example if you google [url=http://www.google.com/search?client=safari&rls=en-us&q=rename+xsan]rename xsan/url you will see Xsanity is in 4th position, just under the apple kbase saying it cant be done.

I do see the advantage of all of us working together to provide comprehensive tome of xsan knowledge. However how do we moderate it? Whats to stop someone who is misguided from putting inaccurate information into the wiki?

One suggestion is we use the wiki as an 'article builder' so we can collaborate on more complex topics then once we are happy it is accurate promote it to a article for the front page? Any 'comments' could be reviewed and integrated if deemed worthy of mention.

T

MattG's picture

BTW - Tim wrote the rename article, not me. :wink:

I have always posted on this site purely for the sake of saving other admins time and frustration, and to thwart the intentions of some institutions that closely guard their in-the-field expertise for the sake of making additional revenue off of it.

I for one have always known that karma will come back my way if I spread the word about what I've learned.

I say at least let's try it and see what happens. It is true that there might be more weight placed on wiki articles than on posts here on Xsanity, but there has never been a more succinct and rich base of knowledge on how to deploy successful solutions with Xsan than today.

aaron's picture

Quote:
how do we moderate it? Whats to stop someone who is misguided from putting inaccurate information into the wiki?/quote

By monitoring the [url=http://wiki.xsanity.com/groups/xsanitywiki/search/index.rss?sort=modifie... feed/url and using the built-in versioning to roll back changes. And anyone can do it.

Aaron Freimark
CEO, GroundControl

pablogott's picture

Tim Burton wrote:

One suggestion is we use the wiki as an 'article builder' so we can collaborate on more complex topics then once we are happy it is accurate promote it to a article for the front page? Any 'comments' could be reviewed and integrated if deemed worthy of mention.

T/quote

I personally think this is a terrific idea. The articles here are well-written and concise, something that new wiki articles will lack. By offering a chance to be promoted, it will give a little more incentive to finish articles.

Aaron wrote:
Also, and more worrisome to me, is the difference between a closely-edited blog and a wiki. The way we work now, when someone posts a well-researched and well-written "How To" to the main site, they get credit. Visitors from Google three years from now will still reference Jason's ACL introduction or Matt's recent renaming tutorial. Wikis, I believe, tend to aggregate and therefor anonymize authorship. Would our authors have written so precisely, knowing that we encourage others to change their handiwork? How important are these sorts of articles to all of you, anyway? /quote

Aaron wrote:
On the other hand, we've only had seven or eight blog authors in the last year, besides me. Maybe -- probably -- participation of this kind would increase. And as Xsan reaches more people -- as Apple is clearly pushing with Leopard and Xsan 2 -- perhaps we should welcome a more accessible and open Xsanity./quote

I don't know nearly as much about xsan as the regular users on this site, but I still want to contribute what I know. For me personally, I would not have the confidence to write an article on my own. So in my case, the wiki will encourage me and hopefully similar users to participate more.

These are all good points. After all, I found this site in the first place by searching google and finding articles (I think the umask article was what brought be here originally).

mark raudonis's picture

As long as we're talking about the Wiki, how about a big, fat, obvious link on the home page that sends inquiring minds out to the wiki?

I know the paint's still wet on the new set up, but once the "Splash" announcement fades, people will still want to know how to get there...

mark

aaron's picture

Quote:
how about a big, fat, obvious link on the home page that sends inquiring minds out to the wiki?/quote

Good idea. I put a bunch of skinny links instead.

Aaron Freimark
CEO, GroundControl