# New Documentation Wiki

**URL:** <https://www.ruby-forum.com/t/new-documentation-wiki/107488>\
**Category:** Radiant CMS\
**Created:** [June 22, 2007, 5:54am UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488 "2007-06-22T05:54:22Z")\
**Posts on this page:** 11\
**Page:** 1

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 5:54am UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/1 "2007-06-22T05:54:22Z")

</div>

I spent the day getting Junebug Wiki up and running on the Radiant Web  
site. I’d like to move all of the documentation from the trac wiki over  
to the new wiki ASP. The new wiki is much more usable than the trac wiki  
and will be accessible through a top level navigation link titled  
“Documentation”.

If you have the time I could sure use some help getting the content from  
the trac wiki moved over to the new wiki. Once we get the content moved  
over, we will shut down the trac wiki.

The new site is over at:

[http://wiki.radiantcms.org](http://wiki.radiantcms.org)

–  
John L.  
[http://wiseheartdesign.com](http://wiseheartdesign.com)

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 7:30am UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/2 "2007-06-22T07:30:31Z")

</div>

On 22/06/07 12:53 AM, John W. Long was heard to say:

> The new wiki is much more usable than the trac wiki

Hi John, I am curious what you mean by that? I personally find the  
Trac wiki just fine especially in combination with the other Trac  
components. Also, by browsing the new Junebug Wiki I noticed that it  
is significantly slower than the Trac Wiki.

Cheers,  
Oliver

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 1:15pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/3 "2007-06-22T13:15:13Z")

</div>

On 6/22/07, Oliver B. [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> Also, by browsing the new Junebug Wiki I noticed that it  
> is significantly slower than the Trac Wiki.

For me, it is very fast.

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 1:24pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/4 "2007-06-22T13:24:01Z")

</div>

I’ve moved a couple pages over and plan to do some more, however I’ve  
noticed a few issues.

The title field should not be edited once set. Junebug Wiki uses this  
for the page url, and if it gets changed, the url changes and breaks any  
wiki formated links on other pages. However this can potentially be a  
minor issue if the following one is fixed.

The title appears in the body of the page. So in pages such as  
[http://wiki.radiantcms.org/HowTo\_Upgrade\_05x\_to\_06](http://wiki.radiantcms.org/HowTo_Upgrade_05x_to_06) it has a heading  
“HowTo Upgrade 05x to 06” at the top. However “How to Upgrade from 0.5.x  
to 0.6” would be a much better heading.

The history and versions pages for a page return an error.

As Oliver says, the site is slow.

All that said, I do like the idea of seperating the documentation from  
the development section (trac) of the site from an end-users  
perspective.

Roydon

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 1:28pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/5 "2007-06-22T13:28:26Z")

</div>

Oh, and one other minor issue. The link to the RSS feed either needs to  
be removed or changed because right now it points to  
[http://feeds.feedburner.com/Wiki](http://feeds.feedburner.com/Wiki)

I do realise that there will be a few kinks seen that this is a new  
system. Just helping find them all. 🙂

Roydon

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 8:58pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/6 "2007-06-22T20:58:23Z")

</div>

Roydon Gyles-Bedford wrote:

> Oh, and one other minor issue. The link to the RSS feed either needs to  
> be removed or changed because right now it points to  
> [http://feeds.feedburner.com/Wiki](http://feeds.feedburner.com/Wiki)

Fixed.

–  
John L.  
[http://wiseheartdesign.com](http://wiseheartdesign.com)

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 9:31pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/7 "2007-06-22T21:31:29Z")

</div>

Oliver B. wrote:

> Hi John, I am curious what you mean by that? I personally find the  
> Trac wiki just fine especially in combination with the other Trac  
> components. Also, by browsing the new Junebug Wiki I noticed that it  
> is significantly slower than the Trac Wiki.

We’ve had a couple of people who thought that documentation for Radiant  
was non-existent because it didn’t occur to them that it might be on the  
dev site. This is the primary reason for the move. It needed a top level  
section like the JuneBug wiki has.

Keeping trac focused on tickets and source is a good move. It’s now  
truly the development site and not the docs+dev site.

–  
John L.  
[http://wiseheartdesign.com](http://wiseheartdesign.com)

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 9:00pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/8 "2007-06-22T21:00:23Z")

</div>

Roydon Gyles-Bedford wrote:

> I’ve moved a couple pages over and plan to do some more, however I’ve  
> noticed a few issues.

Thanks for the help!

> The title appears in the body of the page. So in pages such as  
> [http://wiki.radiantcms.org/HowTo\_Upgrade\_05x\_to\_06](http://wiki.radiantcms.org/HowTo_Upgrade_05x_to_06) it has a heading  
> “HowTo Upgrade 05x to 06” at the top. However “How to Upgrade from 0.5.x  
> to 0.6” would be a much better heading.

I have gone back and forth on this, but I think I prefer the Junebug  
approach now.

> The history and versions pages for a page return an error.

This went away when I restarted the service. Are you still having  
difficulty with it?

> As Oliver says, the site is slow.

Mmm. I’m still tweaking some things. It seems pretty zippy right now.

–  
John L.  
[http://wiseheartdesign.com](http://wiseheartdesign.com)

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 10:04pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/9 "2007-06-22T22:04:33Z")

</div>

On 22/06/07 04:30 PM, John W. Long was heard to say:

> Keeping trac focused on tickets and source is a good move. It’s now  
> truly the development site and not the docs+dev site.

I guess I don’t see if from an end-user’s perspective. Though, I have  
one feature request for the new Wiki: auto-generated anchors to  
subheadings, just like Trac has?

Cheers,  
Oliver

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 22, 2007, 10:17pm UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/10 "2007-06-22T22:17:35Z")

</div>

Oliver B. wrote:

> I guess I don’t see if from an end-user’s perspective. Though, I have  
> one feature request for the new Wiki: auto-generated anchors to  
> subheadings, just like Trac has?

I don’t maintain Junebug, I’ve just customized it to meet my needs:

[http://dev.radiantcms.org/radiant/browser/trunk/wiki/customizations.rb](http://dev.radiantcms.org/radiant/browser/trunk/wiki/customizations.rb)

If you want, you could submit a patch to the Junebug folks, or if you  
give me the relevant code snippet I could copy it into the file above.

–  
John L.  
[http://wiseheartdesign.com](http://wiseheartdesign.com)

---

<div class="post-metadata">

**Author:** ![John\_WSLong](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/j/34f0e0/32.png) [@John\_WSLong](https://www.ruby-forum.com/u/John_WSLong)\
**Post date:** [June 25, 2007, 11:25am UTC](https://www.ruby-forum.com/t/new-documentation-wiki/107488/11 "2007-06-25T11:25:07Z")

</div>

John,

I’m having another issue with the wiki. On trying to edit a couple  
pages: “How to Deploy on A Small Orange” and “How to Deploy on  
Dreamhost”, I keep getting “412 Precondition Failed” on save. It seems  
random because I can enter some content and get it to save, but other  
times I can’t. This happens in both Safari and Firefox.

Roydon
