# First draft of the "Using Radiant" page of the Handbook

**URL:** <https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142>\
**Category:** Radiant CMS\
**Created:** [July 12, 2006, 7:08pm UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142 "2006-07-12T19:08:42Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 12, 2006, 7:08pm UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/1 "2006-07-12T19:08:42Z")

</div>

In an effort to learn more about Radiant, I’ve just completed a first  
draft of the “Using Radiant” page of the Handbook within the Radiant  
Wiki at:

[http://dev.radiantcms.org:9007/radiant/wiki/UsingRadiant](http://dev.radiantcms.org:9007/radiant/wiki/UsingRadiant)

I’m planning on using Radiant as part of a wider site to enable a small  
team to edit documentation without having to go near shell accounts or  
FTP servers, so apart from it being an instruction exercise for myself,  
I needed something like this anyway. I would appreciate feedback and, in  
particular, corrections so that the page can gradually become the  
standard reference for new users before they get adventurous enough to  
examine source code.

Note there is a “TODO” item in there, plus I’ve not even started on a  
lot of the more obvious stuff around the edges (the meaning of  
individual buttons, that kind of thing). If anyone can fill some blanks,  
add some examples, incorporate screenshots or whatever, that would be  
great!

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 12, 2006, 8:54pm UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/2 "2006-07-12T20:54:41Z")

</div>

Andrew,

Thanks! I’m getting started with Radiant and your summary helped me get  
a  
btter look at it.

Sincerely,

Adrian M.

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 13, 2006, 12:13am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/3 "2006-07-13T00:13:38Z")

</div>

Adrian M. wrote:

> I’m getting started with Radiant and your summary helped me get  
> a btter look at it.

Great! Then it was worthwhile 🙂

I’ve made various revisions now, including filling in the outstanding  
“TODO” stuff. Writing the page gave me enough knowledge to start  
experimenting with aspects where I’d made assumptions, which in turn has  
led to clarifications and corrections in some areas.

The way arbitrary named page parts can be defined is neat, but I can’t  
immediately think of a use for it…

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 13, 2006, 12:58am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/4 "2006-07-13T00:58:03Z")

</div>

Andrew H. wrote:

> In an effort to learn more about Radiant, I’ve just completed a first  
> draft of the “Using Radiant” page of the Handbook within the Radiant  
> Wiki at:
> 
> [http://dev.radiantcms.org:9007/radiant/wiki/UsingRadiant](http://dev.radiantcms.org:9007/radiant/wiki/UsingRadiant)

This looks good Andrew. I’m CCing this to our docs mailing list. I’m  
sure it will be helpful as we seek to put some initial documentation  
together.

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

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 13, 2006, 1:35am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/5 "2006-07-13T01:35:19Z")

</div>

Very nice. I read through it and learned quite a bit which is great. I  
noticed a number of typos, nothing major and when time permits I’ll see  
about fixing those.

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 17, 2006, 12:23am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/6 "2006-07-17T00:23:27Z")

</div>

Jay L. wrote:

> Andrew H. wrote:
> 
> > In an effort to learn more about Radiant, I’ve just completed a first  
> > draft of the “Using Radiant” page of the Handbook within the Radiant  
> > Wiki at:
> 
> This is great! Considering that the existing handbook is, er,  
> nonexistent, any reason not to change the link from the main page, other  
> than modesty?

I _swear_ it wasn’t there a minute ago when I looked. More coffee,  
please. Never mind.

Jay

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 17, 2006, 12:51am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/7 "2006-07-17T00:51:38Z")

</div>

Hi all,

I need to translate the admin page into French for one of my client…  
In that regard, I would be very happy to contribute… In your  
opinion, what is the best place to start. Do you recommend something  
as complete as Globalize Rails? Or a more simple solution…

Thanks.

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 17, 2006, 2:38am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/8 "2006-07-17T02:38:02Z")

</div>

Jay L. wrote:

> Relatedly: I don’t really know what this wiki’s rules are; should we be  
> getting permission from John first before making edits, or just diving  
> in and editing it like a community wiki? I’d love to contribute as I  
> learn Radiant.

Please feel free to edit any of the pages on the wiki. Changes are  
reflected on the Timeline RSS feed which I monitor.

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

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 17, 2006, 11:54am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/9 "2006-07-17T11:54:05Z")

</div>

So, given the above, if anyone wants to elaborate on the page just go  
ahead. There’s lots missing (e.g. better examples of tags and  
Behavior-dependent tag descriptions).

It might be better to split it into a series of sub-section pages rather  
than all collected together. At least as it stands people who prefer to  
print and read user guides can do so easily.

---

<div class="post-metadata">

**Author:** ![pond](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/p/7ab992/32.png) [@pond](https://www.ruby-forum.com/u/pond)\
**Post date:** [July 17, 2006, 12:23am UTC](https://www.ruby-forum.com/t/first-draft-of-the-using-radiant-page-of-the-handbook/98142/10 "2006-07-17T00:23:27Z")

</div>

Andrew H. wrote:

> In an effort to learn more about Radiant, I’ve just completed a first  
> draft of the “Using Radiant” page of the Handbook within the Radiant  
> Wiki at:

This is great! Considering that the existing handbook is, er,  
nonexistent, any reason not to change the link from the main page, other  
than modesty?

Relatedly: I don’t really know what this wiki’s rules are; should we be  
getting permission from John first before making edits, or just diving  
in and editing it like a community wiki? I’d love to contribute as I  
learn Radiant.

Jay L.
