[Catalyst] RFC: New to Catalyst questions

Trevor Phillips trevor.phillips at gmail.com
Fri Feb 20 01:18:12 GMT 2009


On Fri, Feb 20, 2009 at 4:41 AM, Rodrigo <rodrigolive at gmail.com> wrote:
>
> Actually, I'd like to work also on a sassier getting-started page for the
> dev.catalystframework.org/wiki site. IMO, the Catalyst Wiki could get a
> makeover: some css styling (so that the wiki is aligned with the homepage),
> column separated content, more short description of links or sections, or
> anything that improves usability really, for beginners and experienced users
> alike.

I agree that the Wiki could do with some work, although I don't mind
the style so much. ^_^ I do think it could be a little better
organised, and promoted though. Also, I think having a prominent "last
modified" date on a Wiki page is a useful indication, and maybe even a
Catalyst Version reference for howtos & code snippets. (Again, a
specialist knowledge base could handle that sort of data & filtering
better than a Wiki I think).

What is the "best practices" for Wiki updates?

Should new articles be posted to this list first, for discussion, or
should they be just whacked into the Wiki, then posted here for
review/deletion?

Is there an alert/review process for Wiki edits? Is there a core team
that will be notified of changes/additions, so they can review/delete?

As someone fairly new to Catalyst, I'm happy to contribute, but I'm
hesitant to jump in & start making changes & additions... Perhaps
there should be a prominent page on the Wiki on how to best contribute
to the Wiki?

Here's some quick observations on things I think could be clearer on
the main Catalyst site too:
  *The main site "Community" link goes straight to the Wiki. How about
a Community page that summarises the Wiki, the mail list, the IRC
channel, etc...
  *The main site "Documentation" goes straight to the manual - yet
there's also documentation in the Wiki. Again, Docs page which deep
links into key pages in the official docs and parts of the Wiki would
be better IMHO.
  *The main site "Developer" jumps straight into the Catalyst
repository (hmmm, there's a theme here). How about clarifying
resources for Developers who work on Catalyst versus Developers who
use Catalyst to develop apps?

-- 
Trevor Phillips  - http://dortamur.livejournal.com/
"On nights such as this, evil deeds are done. And good deeds, of
course. But mostly evil, on the whole."
      -- (Terry Pratchett, Wyrd Sisters)



More information about the Catalyst mailing list