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).
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?
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.
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 12 years, 4 months ago by
Siobhan.
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?
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?
Awesome! It’d be great to have a push on getting a complete bbPress Codex.
Some general thoughts:
-
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.
-
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.
