Siobhan (@wordsforwp)

Forum Replies Created

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

  • Siobhan
    Member

    @wordsforwp

    We discussed using videos in the WordPress Codex. The consensus was that videos were great so long as they were done on an clean, unbranded WP install (localhost or something like that).


    Siobhan
    Member

    @wordsforwp

    Sounds like a good idea to me – lots of users find videos really useful. I guess see what everyone else thinks?

    I have created an FAQ here: https://codex.bbpress.org/faq/

    It’s not published yet but you can see it if you’re logged it. I realised that one had already been started once I’d done it but it only had one question so I integrated it. At the minute I’m just coding the links using an a name – is this the best way or is there a plugin we should be using?

    Also, once something has been added to the FAQ is there any way to “untag” it? Should I comment on the thread that it has been added to and someone else can remove the tag?


    Siobhan
    Member

    @wordsforwp

    Yup, I get that. But there is still a distinction between 1) the people who install and use bbPress to run their forum, and b) the forum members. What I’m wondering is whether we need to provide anything for the forum members (like basic stuff on posting etc) or if we can forget about them. In which case there are just Devs & users.


    Siobhan
    Member

    @wordsforwp

    Sorry for the delay to this – i’m semi-on holiday 🙂

    So this is an interesting question to do with users, end users etc. In fact, should we be producing stuff for forum users as well? I guess we have three groups: Developers Forum Admins Forum Users

    Would that make more sense?

    How about we adopt the following tagging system:

    faq – for something to be added to the faq document – for something to be documented

    Would that make sense? Is there any way to subscribe to tag feeds?

    • This reply was modified 11 years, 7 months ago by Siobhan.

    Siobhan
    Member

    @wordsforwp

    It’s a good idea to split docs out into Developer Docs and User Docs – the user docs could then be split into installation, troubleshooting, and using.

    @lynq – can you drop links to some of the commonly asked questions in here?


    Siobhan
    Member

    @wordsforwp

    Mason and I started to come up with a task list after talking to John at WCNYC. Here’s what we came up with:

    Setting up and running your forum
    bbPress settings (I have some content for this somewhere – will add it as a draft)
    Customizing how bbPress works
    Useful plugins that extend bbPress
    Moderating and managing your forum

    We also had:
    WordPress User Roles and bbPress
    Getting Started with bbPress

    They are complete though.

    Since you guys are on the ground supporting bbPress users, what things in the docs would you like to see prioritized?


    Siobhan
    Member

    @wordsforwp

    Awesome! It’d be great to have a push on getting a complete bbPress Codex.

    Some general thoughts:

    1. Planning the architecture is really important. I get brought on board with a lot of doc projects at a late stage. When no planning has gone into it the docs end up getting unwieldy and difficult to navigate. People just randomly add docs until there is a mountain of information and no user-friendly way of navigating through it. If there is a sound structure from the start it makes sure the complete documentation holds together as it grows.

    2. We should create some sort of task list of doc we would like to see and things to work on. We could use a P2 or a wordpress.com blog, or we could try using bbPress itself for management. If we had a bbPress docs forum then we could add doc suggestions as topics. When a person decides to do it, it becomes a sticky (so that no one else works on it). We could tag posts as idea, in progress, and complete – people would be able to discuss individual posts in the threads. It might be fun to try using bbPress in this way.

    Okay – those are just some ideas. Feel free to disregard – just thought it would be good to get a discussion going.


    Siobhan
    Member

    @wordsforwp

    I’ve added this info to the codex: https://codex.bbpress.org/getting-started-with-bbpress/#creating-your-first-forum

    Does that make it any clearer ken?

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