Not signed in (Sign In)

Vanilla 1.1.5a is a product of Lussumo. More Information: Documentation, Community Support.

    • CommentAuthoravi4now
    • CommentTimeFeb 6th 2008
     permalink
    Hi, I just heard of Chyrp via Daring Fireball, and it looks interesting. However, I noticed a problem right off the bat: the docs are way too low level. For example, I tried out the demo, and browsed the extensions. But nowhere on the site have I found a definition of what a module is, or what a feather. I'm a software architect, so I have a pretty good idea anyway, but I suggest that adoption will be stronger if the home page of "docs" starts out high level, with an explanation of what Chyrp is, how it's architected, and what the various relevant terms are.

    Thanks!
    Avi
    •  
      CommentAuthorAlex
    • CommentTimeFeb 6th 2008
     permalink
    There's a getting_started.html file in the download for that. The documentation at the site is aimed at developers.
    • CommentAuthoravi4now
    • CommentTimeFeb 6th 2008
     permalink
    Yeah, I understand. I'm suggesting that you revamp the docs a little, maybe add in some non-developer documentation.
    •  
      CommentAuthorAlex
    • CommentTimeFeb 6th 2008
     permalink
    This sound arrogant but I really just don't see a need for it beyond that. Using Chyrp isn't the hard part (as far as I know :P), and the Community's here for support.

    There's a Wiki for Chyrp but it's not linked to anywhere; if I find a good place to link it from I'll add it in.
    • CommentAuthoravi4now
    • CommentTimeFeb 7th 2008
     permalink
    Alex, we don't need to get into a debate about it. Hopefully you'll consider my feedback and keep it in the back of your head; I don't know exactly what your goals are for Chyrp, but if they include widespread adoption, then I think you'll eventually need to add some more explanatory content to the site. The wiki might be a good place for that sort of content, if you integrate it into the site a little more, and at least add some scaffolding for that introductory explanatory content.

    Another example of the lack of definition/explanation: the wiki page Creating Feathers says that among others, some of the responsibilities of Feathers are creating and updating Tweets. But I can't find a definition of a Tweet anywhere in the site, the wiki, or the download. I'm guessing that a Tweet is akin to a Post, but I'm not sure. Could be a reference to twitter!

    Here's an alternate suggestion: add some in-line help to the admin interface. When I went in to the demo/admin/extend, there were three tabs on the page, and I didn't know what two of them were. Some kind of in-line help right there, explaining what a module is, what a feather is, a tweet, etc, would be very useful, IMHO.

    Thanks,
    Avi
    • CommentAuthorBruce
    • CommentTimeFeb 7th 2008
     permalink
    avi4now:… some of the responsibilities of Feathers are creating and updating Tweets. But I can't find a definition of a Tweet anywhere in the site, the wiki, or the download.

    That's old terminology.

    upgrade.php:
    function to_103() {
    global $sql, $config;
    $sql->query("rename table `".$sql->prefix."tweets` to `".$sql->prefix."posts`");
    •  
      CommentAuthorAlex
    • CommentTimeFeb 7th 2008 edited
     permalink
    Look, I'm not debating it. I'm just saying that doing this would just result in an area that too much time was put into that no one will use. Time that could have been better spent doing something else. I'm updating the Wiki page at the moment to replace the old terminology, but beyond that most documentation is in the getting_started.html file. If someone else wants to do it I'm not going to stop them, but I'm not going to dedicate time to make a page that explains that the sky is blue.