proposed: Collaboration on user documentation

[wion]

URLs:

back: https://github.com/textpattern/textpattern.github.io/blob/master/brand/user-docs-collaboration.md
front: https://docs.textpattern.com/brand/user-docs-collaboration

Scenario

A doc for recording collaboration procedures, and reference thereafter. This is a new issue for the effort. This is not the same thing as the docs authoring/editing guidelines, which concerns content development.

Resources for consideration

1. researching docs collaboration procedures #116
2. Collaboration guidelines test run
3. Images in docs
4. File naming convention
5. Redirecting
6. Txp github teams

To-dos

Some reflection on the above resources might be needed.

• A workflow diagram to help visualize doc development from ideation to publication.
• A 'Get help' section at end. (Where should the help link point to? Should we talk about roles here, as might be reflected in item 6 above?)
• A section addressing use of images? (Using images is a lot of tedious work, let's remember, see item3 above. This section would be small, though, because how to actually use images would be fodder in the development guidelines.)
• Revise Issues templates to change checkbox lists in the 'Resources...' section to just bulleted lists, and update doc to suggest checkbox lists are useful after issues are created to list sub-tasks for main tasks (as doing here).
• Work in any relevant bits from item 2 above.
• Work in any relevant bits from item 4 above.
• Ensure item 5 above is sufficiently outlined.

[wion]

I had this file started a while back with quite a bit of content in it, but it seems to have disappeared. I don't know what happen to it; might have been during my repo conflict problems I was having. Don't know. Anyway, this is a fresh issue to start fresh.

[wion]

Wow. Nearly a year. This is first tiny step on the dark side of the moon.

[wion]

First draft pushed to fill the hole. I would appreciate anyone giving it a once over too see what they think is missing. I'm sure it will arise eventually regardless.

I've put the 'Editorial workflow' section off for now, but hopefully that won't need much after folks get used to the labeling system. An example workflow might be good though.

I'm thinking it might also be good to add a section for who is most expected to do what in the workflow and assignments as they relate with labels. New collaborators will need this, I think.

Might need to fix a link or two that points to the doc. Can't think where they all are off-hand.

Oh, there might also need to be more clarification on how listed topics from the forum are evaluated and who ultimately does that. Let me know what you think on that.

@Bloke (heh)