Textpattern CMS support forum
You are not logged in. Register | Login | Help
- Topics: Active | Unanswered
Re: [wiki] What's on Your Documentation Wish List?
For the record, my feathers aren’t ruffled in the least, nor are there “blazing fires” around here, not that I see anyway. I agree with everything you said, mgbales, and Elenita, and for the most part 6sigma (though if you think I’m being “(hyper)critical”, 6sigma, I think you’re being (ultra)sensitive.)
Elenita, the thread starter, said it best herself…
Do everyone a favor and put that information in the wiki. That’s the purpose of this post, after all.
I’ve just been trying to emphasize that, in my own, frank way. If anyone thinks I’m “disengenuous” about TextBook, you haven’t done your homework.
Yes, this thread is a wishlist, and it starts with that. It gives potential writers (whoever they are) a place to look for topics to write about — hypothetically. People can interpret that however they want, but it all comes back to what Elenita said above.
mgbales, we need a good article framework, I agree, and since we don’t have one and since you commented about what you would do if TextBook was your editing project, I propose as your first writing assignment you draft TextBook’s article framework guidelines. How’s that? Then you can follow the writing process exactly as you design it. I trust you’ll do it in the interest of the community. Note I have started a thread, Draft: TextBook Writing, Editing, and Collaboration Guidelines, with the purpose of drafting a new set of community-favored guidelines; you might use that thread to your benefit.
Also, I’ve started using TxB’s Community Portal page as a place for documentation suggestions, among other things.
In any case, mgbales, I wouldn’t make it too difficult, because that’s the rub; if you make it too difficult, you make it harder than it already is to get writers. Nevertheless, I do agree, we need a simple and sensible framework in place for potential writers to follow.
Offline