Skip to:
Content
Pages
Categories
Search
Top
Bottom

BuddyPress Codex Review

Viewing 13 replies - 1 through 13 (of 13 total)
  • Avatar of Renato Alves
    Renato Alves
    Participant

    @espellcaste

    Great! We here in Brazil were going to update the BP pt_BR Codex. Now we will wait until is ready.

    Avatar of @mercime
    @mercime
    Keymaster

    @mercime

    @espellcaste cool. Comments/suggestions are welcome :-)

    Avatar of Renato Alves
    Renato Alves
    Participant

    @espellcaste

    None for now @mercime, one of the main complaints I hear around WP and BP communities around here is related to the lack of Codex info. As you guys are addressing this issue now, when translated intro Portuguese, people will be able to understand it, use and extend it better.

    Much of the things I know about Buddypress I learned reading the Codex, so for me it was pretty good for a beginner point of view. But maybe for a more advanced php/WP developer, it still lacks more information.

    Any way, I’m glad you guys are working on this! I’ll keep track of the changes. =)

    Avatar of Hugo
    Hugo
    Moderator

    @hnla

    I think in general the dev documentation is probably lagging behind the more user centric/ beginner type info but that dev docs can be a little harder, more long winded to produce; But this is the sort of feedback we require, an idea of what people find lacking or go to codex for and don’t manage to find.

    Avatar of Diana
    Diana
    Participant

    @dianakc

    Hello!

    I think BuddyPress Codex could stay in a wiki install just like the WordPress Codex. Because BuddyPress docs is still small, I think we could test the Translate Extension for wiki installs. I suggested to use this extension in WP Codex here.

    Avatar of @mercime
    @mercime
    Keymaster

    @mercime

    @dianakc thank you for your feedback :-)

    Avatar of danbp
    danbp
    Moderator

    @danbp

    Hi all,

    an important page should be added: the BP db description and the db diagram
    Such a docummentation exist only for WP at this time.

    http://codex.wordpress.org/Database_Description

    Avatar of @mercime
    @mercime
    Keymaster

    @mercime

    @danbp Noted, thank you :-)

    Avatar of danbp
    danbp
    Moderator

    @danbp

    Another thing would be usefull: a BuddyPress thesaurus or glossary to avoid some mistake…
    Tags, meta value, keywords, and so on. ;-)
    Perhaps also giving some information where they are and how to handle them (with links to the appropriate codex part ?)

    Avatar of @mercime
    @mercime
    Keymaster

    @mercime

    @danbp thank you. We’re going to need volunteers to help out with the codex when the outline is finalized. You will volunteer, yes? :-)

    Avatar of danbp
    danbp
    Moderator

    @danbp

    oh probably @mercime ! :D
    Despite i remember my angry a few month back as i give some tricks, and the discussion who resulted after about codex rules. This must be very clear for everybody too. :roll:

    Who can publih/edit on codex ? Everybody. Magic open source !
    What subject can be published ? Not everything i presume.
    Who moderate/controls the codex content ? ??? Not as censorship, but as reference.

    Also, if some code is given in a codex example, where should it be ? Directly in the post ? On github ? On pastebin ? On another service ? As code is integrally part of BP knowledge, code need also some consistency in it’s presentation, not only in is context, IMHO.
    Linking to post containing code examples is a solution, but what about URL perenity ? Many old post here are no more valuable. And i’m pretty sure that many BP beginners don’t know how to modify manually those URL’s to access such stuff, and this trick doesn’t work always !

    ——————-
    Aside chica, the first time you mentionned me on this post i received a mail with your name.
    @mercime mentionned you”
    The second time, the name whasn’t in. And same thing for the notification on the toolbar. I see only “mentionned you” for the second mention. Ticket or not ticket, or already reported ?

    Avatar of Hugo
    Hugo
    Moderator

    @hnla

    I would personally prefer comments such as this to be made to the:
    http://bpdevel.wordpress.com/2013/08/06/bp-codex-review/ post if possible.

    We will publish a set of proscribe guidelines for codex entries I think and yes clarity on many areas is required.

    As for the the ‘tips & tricks’ issue you refer to I was aware there was some matter of contention a while back, personally I haven’t a problem with a section like this but it requires oversight to ensure bad advice isn’t given which I think is the primary concern.

    Although not formalised I’ll be suggesting that automatic publishing of entries to the codex not happen, I’d be surprised if the WP Codex ran in that fashion and was able to check / proof edit content for accuracy.

    Generally speaking posting code examples to third party sources isn’t a great idea due to services possibly going offline and leaving dead links, this has already happened in a few pages I’ve run across in the BP Codex and is unprofessional, and annoying for users.

    Mercime & I have briefly discussed post formatting and yes there needs to be a format and there is which has been used on a few function examples, we need to track the template down and make a clear ‘writing codex entries’ page pointing to it.

    Avatar of danbp
    danbp
    Moderator

    @danbp

    hi @hnla,
    Hugo i copied my above post to the dev site, as reminder.

    it requires oversight to ensure bad advice isn’t given which I think is the primary concern.

    Absolutely.
    Even if each user can get advices on the forum with exactly the same waranty of quality as from the Codex. Also a codex publisher can post something similar. The only difference maybe be that on the forum, a user post can be sometimes accurate, and on the codex, the same publishing must (or should) always be accurate (at least temporarily) ;-) I fear that there is no good solution for this case.

    {…] is unprofessional

    For sure.

    Glad to read that we are almost on the same point of view about the Codex. Cheers !

Viewing 13 replies - 1 through 13 (of 13 total)

The topic ‘BuddyPress Codex Review’ is closed to new replies.