We had a chat about the CCH last night. Here’s what we discussed:
- the tutorials on installing a desktop servers are nearly complete
- we discussed whether we need to provide tutorials for both SVN and Git. We decided to de-prioritise Git for now and add it in the future if it’s needed
- we discussed the issue of duplication across the handbooks. At the minute this isn’t an issue but it’s something that will need to be addressed at some point.
We can either:
a) copy the content from one place to another and make adjustments to make that content relevant to that specific handbook
b) have a centralised repository where the content is stored and then pulled into the handbook that it’s needed.
Both have pros and cons:
a) duplicating the content means that we can make it very specific to the handbook it’s in. This is better for users but more difficult in terms of management and keeping things updated – we’ll have a lot more to keep up to date.
b) centralising content – this would mean that we’ll lose the specificity which could be a problem in some situations.
I’m going to do some research into how other documentation projects deal with this sort of thing.
- we had a discussion about article length. Some people like shorter articles, some people like longer.
- we discussed having some style advice with regards to language in the handbooks
- we need to have a free SVN GUI that we can recommend for Mac. @japheth recommended this: http://scplugin.tigris.org/ Other than that there is Versions but it’s a commercial product so I’m not sure if we can/should be recommending it.
- we discussed translating the handbooks. How is this going to be done?
Actions
- @rmccue to write up a general workflow for creating and submitting a patch
- me to extend the style guide to include: “American English, “setup” vs “set up”/”login” vs “log in”, comma rules”
- me to check with Simon Wheatley about the status of his multilingual plugin
We’ll keep working through the tutorials and aim to do as much as possible by the next meeting at 22:00 UTC on Wednesday 27th February