On Fri, Feb 20, 2009 at 4:41 AM, Rodrigo <rodrigol...@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) _______________________________________________ List: Catalyst@lists.scsys.co.uk Listinfo: http://lists.scsys.co.uk/cgi-bin/mailman/listinfo/catalyst Searchable archive: http://www.mail-archive.com/catalyst@lists.scsys.co.uk/ Dev site: http://dev.catalyst.perl.org/