Yes, I do think better documentation is definitely a really, really, good idea. The ruby CMS war is only between Refinery CMS and Radiant CMS. I've used both, and I feel that Radiant is the better CMS, especially in terms of the interface and the intuitive way you can utilise ruby code in the site's source code. However, Refinery is much, much easier to set up, and I think that's why it has a larger user-base. If Radiant could refine its installation process, and couple that with some extensive, accessable documentation, I definitely think Radiant could pull ahead.
I'd be happy to document my set up experience, and write extensive documentation regarding the system. I would be able to rewrite "The Basics" and "Extensions" sections entirely, excluding the "Using Extensions" section, as that's really the domain of the community. Saying that, the "Blogs Extension", "Comments Extension", the "Gallery Extension" and "Database Mailer Extensions" appear to extremely useful, and I would probably be able to document these in the future. With regards the "How Tos", I'd be more than happy to explain just how to: "Use Radiant as a Blog", "Make a sitemap", "Utilise inline CSS", "Output All Page Parts", "Rest Admin Password", "Change a Page's Publication Date", "Make a Template from an Existing Site", "Migrate SQLite to MySQL" as well as "Setup a SQL Server Database" I also feel that "Making a Template From An Existing site" and "Migrating from SQLite to MySQL" are so necessary that they should actually be located as an optional section of the installation. Anyway, those are my thoughts, and I would be genuinely be more than happy to kick-start these sections of the documentation. I can also tell you exactly where the weaknesses in Radiant's installation process lie. All I ask for in return is that you can clarify my questions, which, to be fair, you have been! All the best, Julian Hurley On 22 May 2013, at 17:30, Andrew vonderLuft wrote: > Hi Julian, > > Here is some more input on your questions and concerns. > > 1) On documentation: yes we need more contributors to the project. If you > end up liking Radiant perhaps you could help us out. :-) Have you looked > here: https://github.com/radiant/radiant/wiki ? > > 2) On using assets: On each edit pane (pages, snippets, layouts) there is a > reference link for "Available Tags" This pops up a reference, searchable by > "Filter Tags" which shows all the available radius tags. If you filter by > "asset" you'll find all the tags used to display assets on pages. As far as > referencing assets in source code, you probably wouldn't do that much, but > use the CMS itself and the tagging language. But to answer your question, > the assets are stored in ~/public/assets. If you want to look at the radiant > source code itself, assuming you're using the gem, you can edit `bundle show > radiant` from your app root. > > > -- > > --- > You received this message because you are subscribed to the Google Groups > "Radiant CMS" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > For more options, visit https://groups.google.com/groups/opt_out. > > -- --- You received this message because you are subscribed to the Google Groups "Radiant CMS" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/groups/opt_out.
