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

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

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!

Andrew,

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

Sincerely,

Adrian M.

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 :slight_smile:

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…

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

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

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.

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

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.

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

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.

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.

This forum is not affiliated to the Ruby language, Ruby on Rails framework, nor any Ruby applications discussed here.

| Privacy Policy | Terms of Service | Remote Ruby Jobs