Hi - I'm newish to Radiant and am spending a lot of time trying to figure out why things don't work and reading documentation. I'd like to contribute to the documentation parts that I have learned but aren't documented. For instance in the handbook there is a section called standard tags, but it doesn't list the <r:snippet name=â€snippet_nameâ€ /> tag. Pretty simple to add that. I did see it documented under the snippets category but it should be documented under standard tags too. Another thing I might add is how to build an app and write pages using the rails_support extension I found on the google code site. I've written two websites using this now and I think my contribution to another tutorial will help. Who do I contact to be able to edit the online handbook? Also if I am approved I need to know the policy for making changes . . . should I forward any changes to John L. or Sean C. for approval? That would make sense to me. Thanks, Steve Line
on 2008-11-16 03:07
on 2008-11-16 03:09
Another thing I would like to add is how to build a text/css layout and use that as the css for other layouts. I haven't figured out how to do this yet, but will document it when I figure it out. I would like it to be better documented. Steve
on 2008-11-16 08:21
HI Steve, It's great to receive your message - we are obviously always on the lookout for people who can help write documents for Radiant, based on their experience. Steven L. wrote: > I'm newish to Radiant and am spending a lot of time trying to figure out > why things don't work and reading documentation. I'd like to contribute > to the documentation parts that I have learned but aren't documented. > Great! > Another thing I might add is how to build an app and write pages using > the rails_support extension I found on the google code site. I've > written two websites using this now and I think my contribution to > another tutorial will help. > > Who do I contact to be able to edit the online handbook? Also if I am > approved I need to know the policy for making changes . . . should I > forward any changes to John L. or Sean C. for approval? That > would make sense to me.  Editing the wiki The documentation for Radiant starts from this page: http://wiki.radiantcms.org/Documentation At the bottom of each page in the wiki, you can click on 'Edit page' to edit it. You will be asked for an email address and password. If this is your first visit, enter a valid email and a password that you would like to use. If you are returning, just enter your previously entered email address and password. There is no approval/ moderation needed by anyone - you can edit straight away.  Summer Reboot - http://wiki.radiantcms.org/Summer_Reboot Another Radiant documentation project that is ongoing is the Summer Reboot. We drew up a table of contents once for what would be a good set of items to document for people using Radiant. You can see the full list at that site and add to any of the yet-undocumented items. You could also add your own extra topics if you want. Under Chapter 6, there is a topic called 'Integrating with Rails' - you could use that (or change it appropriately) to document the rails_support extension. If you are unsure where the topic belongs, just create it in and we can shift it later. Creating a new wiki page: the easiest way to create a new wiki page is to go to the parent page from which it will be linked. Then, click on Edit Page to edit it. Find the part where you want to create the link from and put the wiki linking part into [[ link text name]]. For example, if you want to add to Chapter 6 - Integrating with Rails, scroll down to the part where you see this: * Integrating with Rails and change it to: * [[Integrating with Rails]] Click on Save - on the rendered page, it will show with a small ? next to the text. Click on that to be taken to the new page that you can now add content into. NOTE: Do not change the title of the new page. If you change it, it won't be correctly linked back because that will automatically change its URL. Please feel free to add anything that you want to the sections. In case you need any clarifications, please feel free to contact me/ mail the list. Remember to add your name at the bottom to the authors list on the Summer Reboot page once you modify it. Cheers, Mohit. 11/16/2008 | 2:20 PM.
on 2008-11-16 08:23
Steven L. wrote: > Another thing I would like to add is how to build a text/css layout and > use that as the css for other layouts. I haven't figured out how to do > this yet, but will document it when I figure it out. I would like it to > be better documented. > Steve, I don't fully understand what you mean. Could you take a look at this article on the Summer Reboot about getting started and see if it helps you. Do Steps 2 and 5 answer what you want? Cheers, Mohit. 11/16/2008 | 2:22 PM.