11 April, 2013
Filed under CiviCRM, Documentation, Drupal

The attached chart came out of a discussion between Kasia Wakarecy, Lola Slade and myself (Lynna Landstreet), at Freeform Solutions, about some issues we'd encountered when trying to to do major version upgrades of CiviCRM and Drupal on a client's site at the same time. Since we're likely to have a number of other combined upgrades like that to do in the future, we wanted to iron out the best process for doing them as smoothly as possible.

And we thought it might be useful to share what we’ve got thus far with others in the CiviCRM community, partly because it might help other people, and partly to find out others’ experiences: do you agree with what we’ve outlined here? Disagree? Have anything you’d want to add/change? We’re thinking of contributing this to the wiki documentation, but wanted to post it here for discussion first.

The pink boxes on the chart represent the actual steps involved, with the green ones being the state of the site(s) you’re working on...

Read more
03 December, 2012
Filed under Documentation

Do you modify template files for your site?  If so, you ought to know the tedious process of updating all the overridden template files every time you upgrade.  (If you don't know that pain, either you've never upgraded or you should quit reading and go check your customized files.)

The method of using .extra.tpl files is helpful for tacking some jQuery on the end, but if you're altering parts of the page or adding to the middle, you've got to copy the whole template file and modify it.

At AGH Strategies, a number of clients have lots of customized templates, and when we run upgrades for them, we need a reliable and efficient way to separate the customizations from the rest of the file that's just copied from CiviCRM.  We'll then apply the changes to new...

Read more
20 November, 2012

Just created a quick ERD for CiviCase, and shared it on this page http://wiki.civicrm.org/confluence/display/CRMDOC42/CiviCRM+ERD+3.3.

It is version 3.3, so not the latest and greatest. But I am sure I will have to check the same ERD for version 4 at a near point in the future and update the ERD too. And I do not think there are major differences in the data model......

I have also attached the ERD to this blog post.

28 September, 2012
Filed under Documentation


We've tackled a fair amount of work at the recent Apeldoorn and Butcombe documentation sprints.  As well as documenting pretty much all of the new features for 4.2 (including SMS) - special thanks to Simon West for doing so much of that - we've made some significant improvements to our infrastructure, reviewed a few sections in the book, and added a number of areas of work to the documentation road map.  It feels like we are getting into a good rhythm these days with a book sprint every 6 months enabling us to keep fairly up to date with the release cycle. Never the less, the list of things to do keeps on expanding, and there is certainly lots more that we (and the we includes you!) need to do do to improve our documentation.

Every book sprint is unique and different to the last...

Read more
04 April, 2012
Filed under Documentation

We're at the book and documentation sprint out at the very lovely Woolman Centre near Nevada city in California. A sub group of us have taken on the mighty task of analysing how the wiki content sits with the book content. We're focusing on the User and Administrator guide at the moment, which is online at http://book.civicrm.org/user/.


What we're doing, is each taking a section of the book at a time, then going through the wiki - http://wiki.civicrm.org/confluence/display/CRMDOC and finding all related content.


We're then labelling the wiki pages in 2 ways:

1. According to which section of the book the page corresponds to e.g. 'basic-set-up' or 'events'.


2. An indication of the relationship between the wiki page and the book. One of the following 4 labels: 


Read more
02 March, 2012
Filed under Documentation

We're wrapping up the London code sprint today. We've done a decent amount of book review, which will stand us in good stead when we get to Woolman and we've also made some minor improvements to the books at book.civicrm.org.

Books now have a 'breadcrumb' which show you what section you are reading and they also have proper titles, which should make them more visible when people are googling for help.

It would be great to hear other ideas for improving the publication process.

My number one improvement would be some form of funky jquery commenting system would be great if you want to suggest one.  I'd also like to get rid of the enforced caps in sections and chapters in the menu (which is also reflected in the page title).

Feel free to download and play around with the publishing script (it is pretty easy to get to grips...

Read more
28 February, 2012
Filed under Documentation

We're doing a fair amount of work on the book review at the London sprint. It would be cool to have others involved (remotely or in person).  If you want to help out then

  • come along to CAN Mezzanine (let us know if you are coming) or
  • jump on IRC and say hello (during London friendly hours) or
  • subscribe to the book list and send us an email.

The best places to start and orient yourself are:

You might also want to read through...

Read more
19 February, 2012
Filed under Documentation

If you have a look back over the documentation (previously book sprint) blog tag, you'll see that over the past few months we have been making slow and steady improvements to our documentation.  We've moved the books over to CiviCRM.org and clarified the relationship between the book and the wiki.  It has been pretty fun so far, but there is still lots to do, one of which is a decent review of the user and admin guide...

After the last book sprint we realised that we have come to a point where, in order to be really effective at a book sprint, we need to have a solid understanding of the state of the current book before we start.  In earlier sprints, this wasn't such a big deal as we could just get together and pump out the content, but now that our...

Read more
09 January, 2012

There are various CiviCRM events coming up in London this February, indeed there is 'something for everyone' regardless of your level of experience and familiarity with CiviCRM.  If you can't make it over to the US this April, you should definitley consider participating in one or more of these events...

CiviCRM meet-up

We are starting off on the 8th February with a CiviCRM meet-up - an informal after work event at Third Sector Design's offices at TechHub, Old Street.  We'll have two presentations showing off what you can do with CiviCRM, a Q+A session and a chance to meet and mingle with other CiviCRM users and developers.  Meet-ups are free a great way to get to learn more about CiviCRM and are suitable for those that are new to CiviCRM as well as people that have been using it for years. ...

Read more
17 December, 2011
Filed under Documentation

For the past couple of years (since May 2009) we've used Flossmanuals to write our CiviCRM books. In August this year, our old faithful Comprehensive guide to CiviCRM became two: The CiviCRM user and administrator guide and The CiviCRM developer guide. The user and administrator guide is now in its fourth version and we're currently writing new training guides for administrators and developers. We are also experimenting with sector specific introductions and it feels like we are headed towards a pretty comprehensive set of documentation for CiviCRM.

Up until now, the books have lived in their own little orange world on Flossmanuals, and while that orange world (filled with strange creatures like Booki and Objavi) has been good to us, we've wanted to move our documentation closer to civicrm.org for a while. There are lots of...

Read more