Growing Venture Solutions - GVS - Planet Drupal http://growingventuresolutions.com/taxonomy/term/1/0 en GVS, Drupal Scout, acquired by industry leader Acquia http://growingventuresolutions.com/blog/gvs-drupal-scout-acquired-industry-leader-acquia <p>We're excited to announce that Growing Venture Solutions and <a href="http://drupalscout.com/">Drupal Scout</a> have been acquired by <a href="http://acquia.com/">Acquia</a>. As a leading provider of cloud and support services for Drupal, it was clear that Acquia provides a unique complement of infrastructure and scalability to Drupal Scout. Following discussions about how best to work together, we decided to join the Acquia team. As a result, several GVS brands and the core GVS team are now part of Acquia. We are really excited for this opportunity.</p> <h3>Plans for GVS brands</h3> <p>In addition to the expert Drupal consulting, security training, security review services that we'll be taking to Acquia, GVS has several spinoff brands, many—but not all—of which are now part of Acquia.</p> <ul> <li><a href="http://www.masteringdrupal.com/">Mastering Drupal</a>: screencasts and e-books for learning Drupal. The Mastering Drupal brand and content are a great complement to the existing <a href="http://library.acquia.com/">Acquia Library</a> and <a href="http://training.acquia.com/">Acquia training</a></li> <li><a href="http://usecod.com/">UseCOD.com</a>: Branding for the Conference Organizing Distribution. COD will remain a community distribution, and Ezra plans to continue as the project's maintainer. Moving the brand lets us put more marketing muscle behind it for increasing adoption of the platform and Drupal. We've got more details about the <a href="http://usecod.com/news/2011/usecod-news-august-2011">future of COD</a> on that site's blog.</li> </ul> <p>In contrast to those projects/brands:</p> <ul> <li><a href="http://certifiedtorock.com/">Certified to Rock</a> will remain an independent project. We are working to establish a broad team of Drupal community members to manage the service. The current CTR team will continue to play a big role in the project. If you are interested in helping to run CTR, read more about the <a href="http://certifiedtorock.com/blog/certified-to-rock-groupies">CTR groupie</a> program.</li> </ul> <h3>Plans for GVS team</h3> <p>The core GVS team will be joining Acquia.</p> <ul> <li>Greg and Ben will help grow Acquia's security offerings, with Greg as the Director of Security Services and Ben as a Senior Engineer focusing on products for Drupal security.</li> <li>Ezra is bringing his experience as a distribution maintainer to the <a href="https://acquia.com/products-services/acquia-commons-social-business-software">Acquia Commons distribution</a>, where he'll be working as a Senior Engineer.</li> <li>Continuing her focus on user experience, Lisa will be working on a range of Acquia products as a Usability Specialist.</li> <li>Instead of joining the rest of the team at Acquia, Carl will continue to work as an independent consultant and trainer in the Denver area.</li> </ul> <p>We're so grateful to our clients and to the amazing Drupal community who helped to make this possible!</p> <p>For now we will all be staying in the same locations. You can expect to see us at events in New York and Colorado just like always.</p> <p>As individuals we may make the time to blog about why we joined Acquia and our time at GVS. <a href="http://knaddison.com/drupal/career-update-director-security-services-acquia">Greg did</a> already.</p> http://growingventuresolutions.com/blog/gvs-drupal-scout-acquired-industry-leader-acquia#comments Planet Drupal certified to rock Drupal Scout security Tue, 16 Aug 2011 20:02:10 +0000 Team GVS 1406 at http://growingventuresolutions.com Selecting conference session proposals: popular vote? selection committee? http://growingventuresolutions.com/blog/selecting-conference-session-proposals-popular-vote-selection-committee <p>I was on the "Ecosystem" track session selection team for <a href="http://london2011.drupal.org/">Drupalcon London</a>, which motivated me to finally do some more analysis on the traditional pre-selection session voting. Specifically, I wanted to compare the votes a session receives against the evaluations submitted after the conference.</p> <p><em>By the way, if you have the opportunity, I highly suggest going to a <a href="http://drupalcon.org/">Drupalcon</a>; they are always great events.</em></p> <p>Here are some conclusions based on analysis of the evaluation and voting data from DrupalCon Chicago:</p> <ul> <li>Voting was not a useful predictor of high quality sessions!</li> <li>The pre-selected sessions did not fare better in terms of evaluation than the other sessions (though they may have served a secondary goal of getting attendees to sign up earlier).</li> <li>We should re-evaluate how we do panels. They tend to get lower scores in the evaluation.</li> <li>The number of evaluations submitted increased 10% compared to San Francisco, which seems great (Larry Garfield theorizes it is related to the mobile app, I think there are a lot of factors involved)</li> </ul> <h3>Is voting a good way to judge conference session submissions?</h3> <p>Drupalcon has historically used a voting and committee system for session selection that is pretty common. This is also the default workflow for sites based on the <a href="http://usecod.com/">Conference Organizing Distribution</a>.</p> <p>Typical system:</p> <ol> <li>Users register on the site</li> <li>They propose sessions (and usually there is a session submission cutoff date before voting)</li> <li>Voting begins: people (sometimes registered users, sometimes limited to attendees) can vote on their favorite sessions</li> <li>During steps 2 and 3, a session selection committee is encouraging submissions and contacting the session proposers to improve their session descriptions</li> <li>Selection begins: Voting closes and the session selection committee does their best to choose the right sessions based on factors like appropriateness of content to the audience, the number of votes, their knowledge of the presenter's skill, diversity of ideas</li> <li>???</li> <li>Profit</li> </ol> <p>Drupalcon Chicago (the event I'm basing this analysis on) had a few changes to that model. They pre-selected some sessions from the people they knew would submit sessions and get accepted (see their <a href="http://chicago2011.drupal.org/news/submit-your-session-proposal-drupalcon-chicago-today">blog post on that</a> and the <a href="http://chicago2011.drupal.org/speaker-faq">faq</a>). This allows us to see whether pre-selecting actually brought in sessions that were more valuable to people which seems like a decent proxy for whether or not the committee's choices are right.</p> <p>The pre-conference voting had 5 stars with the following labels:</p> <ul> <li>I have no interest in this session</li> <li>I would probably not attend this session</li> <li>I might attend this session</li> <li>I would probably attend this session</li> <li>I totally want to see this session</li> </ul> <p>The post-session evaluations had 5 stars with the following criteria:</p> <ul> <li>Overall evaluation of this session</li> <li>Speaker's ability to control discussions and keep session moving</li> <li>Speaker's knowledge of topic</li> <li>Speaker's presentation skills</li> <li>Content of speaker's slides/visual aids</li> </ul> <p>I've previously looked at the percent of the attendee population that actually gets to vote and the distribution of votes (1 to 5) to see if that was actually used in a meaningful way in Chicago (that analysis is on <a href="http://groups.drupal.org/node/106579">groups.drupal.org</a>). Given the distribution of votes in Chicago across the entire 1 to 5 spectrum, I believe it is useful to use a 5 star system as a rating on a session. However, I don't think the resulting value is directly useful by the session selection committee when they choose individual sessions (more on that later).</p> <p>My analysis method was to create a nice spreadsheet with the average and count of votes on sessions from the pre-conference period where votes were used to help determine which sessions to include. Then I added in the votes (from 1 to 5 stars) which covered several categories.</p> <p>I graphed the pre-conference votes compared to the post-conference evaluations and used the "<a href="http://wiki.services.openoffice.org/wiki/Documentation/How_Tos/Calc:_CORREL_function">correl</a>" function to see how correlated the data is. I expect a straight line correlation: the higher the average votes, the higher the post-conference evaluation scores. In fact, there was basically no correlation.</p> <p>What I found was that there is basically no correlation between the pre-conference voting and the post-session evaluations. Here is a table that shows the axis (i.e. one of those 5 elements above) and the correlation between that axis and pre-conference session votes.</p> <table> <thead> <tr> <th>Axis</th> <th>Correlation (r)</th> </tr> </thead> <tbody> <tr> <td>overall</td> <td>-0.00615455064217481</td> </tr> <tr> <td>control</td> <td>0.0528419859853818</td> </tr> <tr> <td>knowledge</td> <td>0.0907826506020892</td> </tr> <tr> <td>presentation</td> <td>0.00493457701973411</td> </tr> <tr> <td>visuals</td> <td>-0.0216904506593498</td> </tr> </tbody> </table> <p>As a graph, the overall data looks like:</p> <p><a href="http://growingventuresolutions.com/gvsfiles/distribution_overall_session_score_votes.png"><img src="http://growingventuresolutions.com/gvsfiles/distribution_overall_session_score_votes_thumb.png" /></a><br /> <em>This data is not correlated. Just look at it, spaghetti soup!</em></p> <p>I graphed it along with a random line that has a correlation value of .95. As you can see, the overall evaluation is not at all correlated to the outcome evaluations.</p> <p>It isn't surprising that <strong>votes don't correlate to session quality</strong>. Voting tends to be done by a minority of event attendees who are "insiders" to the event. They are likely to be swayed by friendships, employers, and social media campaigns.</p> <h3>Comparing pre-selected sessions to regular sessions</h3> <p>I also took an average of the evaluation scores across non-pre-selected-sessions and the pre-selected sessions. The average overall evaluation score for non-pre-selected sessions was 80.9 vs. 80.7 for pre-selected sessions. The other axes show similar results except for knowledge and visuals, though it's not clear if those are statistically significant.</p> <table> <thead> <tr> <th>Axis</th> <th>Pre-selected average evaluation score</th> <th>Non-pre-selected average evaluation score</th> </tr> </thead> <tbody> <tr> <td>overall</td> <td>81</td> <td>81</td> </tr> <tr> <td>control</td> <td>83</td> <td>83</td> </tr> <tr> <td>knowledge</td> <td>93</td> <td>91</td> </tr> <tr> <td>presentation</td> <td>80</td> <td>81</td> </tr> <tr> <td>visuals</td> <td>78</td> <td>75</td> </tr> </tbody> </table> <p>So, we can see that regularly selected sessions got very similar scores to the pre-selected ones. I'm not suggesting that pre-selecting is flawed (it didn't produce lower results, anyway), but I do think we should carefully consider who we pre-select.</p> <p>The third bit of analysis I did was to look at overall score, and the number of presenters for that session. Here's the average per decile where decile 1 is the 9 sessions that were ranked highest. Seems like a pretty clear trend from nearly 1 person for the top rated sessions to 2.5 people for the bottom rated sessions.</p> <table> <thead> <tr> <th>Average # of presenters</th> <th>Decile</th> </tr> </thead> <tbody> <tr> <td>1.11</td> <td>1</td> </tr> <tr> <td>1.67</td> <td>2</td> </tr> <tr> <td>1.89</td> <td>3</td> </tr> <tr> <td>1.44</td> <td>4</td> </tr> <tr> <td>1.67</td> <td>5</td> </tr> <tr> <td>2.33</td> <td>6</td> </tr> <tr> <td>2.00</td> <td>7</td> </tr> <tr> <td>2.00</td> <td>8</td> </tr> <tr> <td>2.44</td> <td>9</td> </tr> <tr> <td>2.50</td> <td>10</td> </tr> </tbody> </table> <p>I believe there are two big reasons for this. First, panel presentations are rarely done in a well-coordinated manner and the panel members usually don't take time to practice as a group (our distributed community makes that hard). Second, Drupalcon session selection committees often suggest similar topics get merged into one panel. I think we should <strong>stop merging independent presenters.</strong> The result is often that people who may not have the same story to tell end up putting 45 minutes of information into one-half or one-third of the time.</p> <h3>What can we do to improve session quality and session selection?</h3> <p>One of the great tools for session selection committee members at Drupalcon London was the availability of evaluation data from previous conferences. If a proposed session got a lot of votes (perhaps due to a campaign on twitter or within a large company) but the presenter had horrible evaluations from a previous conference then the evaluator has an easy job: just say "no thanks".</p> <p>The only problem with using previous conference evaluations to judge sessions is that it can lead to stagnation among the presenters. Part of the value of a conference is in hearing new ideas. This can be reduced by having free-for-all BOF sessions, but I think in the Drupal world that part of the solution is to use Drupalcamps as a ramp into Drupalcon: presenters should give their session at a camp and mention that (and any evaluations from the camp, any video from the camp) in their session proposal. With approval from presenters, Drupalcamp Colorado <a href="http://2011.drupalcampcolorado.org/news/drupalcamp-colorado-2011-wrapup">published our evaluations</a> - we hope this helps other camps and that they will do the same. It's not surprise that <a href="http://drupal.org/node/930072">some</a> <a href="http://drupal.org/node/1223800">feature</a> <a href="http://drupal.org/node/1176604">requests</a> for COD will help make the process of gathering this information and getting it to the right people much easier.</p> <p>See also a great discussion on groups.drupal.org: <a href="http://groups.drupal.org/node/151174">On popular voting and merit-based selection of sessions</a>.</p> <h3>What else can improve session quality?</h3> <p>So far I've talked about identifying good sessions, but I think the nature is more complex. It's also about encouraging and inspiring the presenters to do great work on their sessions. We can tell them "please practice it 10 times" but nobody will do it if they aren't motivated. Sending reminder mails to presenters like "we expect 3,000 attendees including key decision makers from companies like Humongo Inc." could help. There's also the possibility of compensating presenters. Drupalcon Chicago gave a mix of cash and non-cash benefits (massage chair, faster check-in line).</p> <p>Scott Berkun gives some tips on how to improve the presenter experience at a conference in <a href="http://www.scottberkun.com/blog/2011/an-open-letter-to-conference-organizers/">An open letter to conference organizers</a>. He recommends a lot of things including sharing the results of the evaluation data. I'm in favor of that as well...(<a href="http://drupal.org/node/1223870">provide default terms of attendance</a>).</p> <h3>Extra note: Want to see your evaluations from Chicago? Just needs more code</h3> <p>There were evaluations in Chicago, but the speakers have not seen this data. I got access to it as part of my role on the London session selection team and my work on the infrastructure team/Chicago sites.</p> <p>However, the fact that presenters can't see it is a result of a bug in software that you can help fix. The organizers of Drupalcon want to share that information, but the <a href="http://drupal.org/node/930072">code to do that</a> isn't fully working. If you can help make it work then all session presenters will be able to see their evaluations.</p> <div class="field field-type-nodereference field-field-related-project"> <div class="field-label">Related Project:&nbsp;</div> <div class="field-items"> <div class="field-item odd"> <a href="/portfolio/drupalcon-chicago-2011-site">DrupalCon Chicago 2011 Site</a> </div> </div> </div> http://growingventuresolutions.com/blog/selecting-conference-session-proposals-popular-vote-selection-committee#comments Planet Drupal conference organizing distribution statistics strategery Wed, 03 Aug 2011 22:32:43 +0000 Greg 1389 at http://growingventuresolutions.com COD Beta1 Released, Packed with Features http://growingventuresolutions.com/blog/cod-beta1-released-packed-features <p>We're excited to announce that COD Beta1 has been released and is loaded with great new features, including:</p> <ul> <li>Enhanced conference administration menu</li> <li>Automated sponsorship sales</li> <li>Birds of a Feather scheduling tool</li> <li>Automated speaker confirmation and contact</li> <li>More granular control over the event registration workflow</li> <li>Ability to collect profile information for free events</li> <li>Session editing for multiple speakers</li> <li>Improved attendee check-in</li> <li>Better Ubercart reporting for purchased registrations</li> <li>Integration with RegOnline and Etouches</li> </ul> <p>You can <a href="http://usecod.com/news/2011/cod-beta1-packed-gills-features">read more about these features on UseCOD.com</a>.</p> http://growingventuresolutions.com/blog/cod-beta1-released-packed-features#comments Planet Drupal conference organizing distribution release Wed, 13 Jul 2011 18:27:06 +0000 Ezra 1383 at http://growingventuresolutions.com Voting, Profiles & Hot content: Tools to help the Drupal community scale http://growingventuresolutions.com/blog/voting-profiles-hot-content-tools-help-drupal-community-scale <p>Drupal is growing in complexity and growing simply in sheer numbers. We need more tools to help people manage the information overload and find the best voices in our community quickly. We should build dynamic tools to empower community members to join in and share their voices (if those voices are valuable) rather than walled gardens that keep people out. I believe voting, richer profiles, and the hot content are steps to help enable that vision. That said, the implementation has to match the community values. Below I've laid out the story of how some improvements to Groups.Drupal.org were made, provide data behind some of those improvements, and ask some questions so we can keep refining them.</p> <p>At <a href="http://sf2010.drupal.org/">Drupalcon San Francisco</a> there was a sprint for groups.drupal.org features where <a href="http://drupal.org/user/3313">Josh Koenig</a> and <a href="http://drupal.org/user/139189">Brian Gilbert</a> helped out add some new features. In particular we added voting on nodes &amp; comments and we added a "<a href="http://groups.drupal.org/hot">hot</a>" page which incorporates several elements to determine which content on the site is interesting in the last week.</p> <p>I wanted to look back on the past year to think about these changes and whether or not they are an improvement.</p> <h3>Hot Content: G.d.o <em>is a differentiated piece of $<em>#!@$</em>&amp;</em></h3> <p>Randy Fay recently wrote about how <a href="http://www.randyfay.com/node/104">Drupal.org doesn't differentiate in quality of content</a> and he's absolutely right about a lot of the site. The only way to know what posts/comments are good is if you've been around enough to get a sense of people's reputation and maybe have a perspective on their content. For drupal.org, my colleague Lisa is working on a <a href="http://drupal.org/community-initiatives/drupalorg-content-strategy">Content Strategy</a>, which is what we ultimately need. I don't agree with all of Randy's ideas, but one of them I agree with is that we need better ways for the community to find the best content. Groups has that!</p> <p>The <a href="http://groups.drupal.org/hot">hot</a> content on groups.drupal.org helps feed people's desire for great content. According to Google Analytics this page is in the top thousand or so for most popular with a <strong>bounce rate of just 23%</strong> For comparison, <a href="http://groups.drupal.org/jobs">Jobs</a> is perpetually one of the top pages on the site and has solid value as a guide to content useful to visitors, it also has a comparatively low bounce rate of 29% which is a bit higher than the hot content. That makes the Hot page a pretty solid resource on the site for finding content, especially considering it's just a year old and has no primary navigation linking to it.</p> <h3>Voting on content &amp; comments</h3> <p>Groups.drupal.org is using the <a href="http://drupal.org/project/vote_up_down">Vote Up Down</a> tool which has both up/down AND the ability to do just Up voting (my thanks to <a href="http://drupal.org/user/132175">Marco Villegas</a> for his help with the module). My feeling was that this tool would provide a simple way for folks to say "I agree" or "I disagree" without having to get into a long debate about exactly why. It helps bridge the gap for users who want to provide feedback to the conversation but don't want to fully invest in a comment, or don't want to create an e-mail notification for their action.</p> <p>Below is a graph that shows a breakdown of the sum of votes on content (both nodes and comments):<br /> <img src="http://growingventuresolutions.com/gvsfiles/distribution_of_sums.png" /></p> <p>This graph shows that of the 12,117 pieces of content that are rated, more than half of it ends up with a +1 total score (6,810 items). Almost 9,000 items end up with a positive score while about 2,400 items have a negative score (about 750 items had a net zero score).</p> <p>Looking at individual voting habits, 7,400 people have placed a vote. Among those, there are 2,960 who placed a down vote and 5,630 who placed an up vote.</p> <p>The sum of votes for individuals shows whether on whole they are more in agreement or disagreement: a person with 2 up votes and 1 down vote would have a sum of 1. The data shows that the sum is a negative number for about 1,800 people and a positive total for over 4,600 people. These two items show that most people use votes to be positive in whole even if they periodically have a down vote.</p> <p>My hope was that voting would help reduce tension among groups on the site. In the time I've co-managed the site since Drupalcon Paris we have had 3 regional groups in particular that had a large number of disagreements that rose to the level where concerned group members needed to ask for outside help. Those disagreements led not only to me instituting this voting tool, but also to Moshe creating the <a href="http://drupal.org/dcoc">Drupal Code of Conduct</a>. Has voting or the DCOC helped those groups to interact more civilly? It's hard to say.</p> <p>I personally find both up and down votes of other users to be valuable as I read a thread. It helps me get a sense of what other people on the site think.</p> <p>What do you think? Is voting useful on g.d.o? Should we remove the option to downvote? Should we make it possible to see who did which votes?</p> <h3>Improved user profiles:</h3> <p>A few months ago my colleague Ben added some fields to user profiles. Now the site displays a mix of user entered data AND automatically generated information.</p> <p><a href="http://groups.drupal.org/user/58"><img src="http://growingventuresolutions.com/gvsfiles/gdo_richer_profiles.png" title="Annotated version of my profile" /></a></p> <p>It's now possible to take a quick glance and see a user's level of interaction on the site from posting content, to voting, to events organized and groups organized.</p> <p>Groups has long used avatars, a feature which is valuable to help reputation/recognition when scanning a page. Try looking at a forum post with a lot of comments on d.o and quickly identify comments by people you know. Now try it on g.d.o. See?</p> <p>Voting and reputation are something that's particularly interesting to me since it relates to the session selection process in <a href="http://usecod.com/">conference sites we build</a> and the <a href="http://certifiedtorock.com/">Certified to Rock</a> system. I'll be writing more about voting on sessions as it relates to Drupalcon in the next few weeks.</p> <p>What else can we do to improve the day to day interactions with these sites? How can we elevate the conversations?</p> http://growingventuresolutions.com/blog/voting-profiles-hot-content-tools-help-drupal-community-scale#comments Planet Drupal reputation statistics Tue, 24 May 2011 22:12:10 +0000 Greg 1341 at http://growingventuresolutions.com You should come to Drupalcamp Colorado June 11-12 2011 http://growingventuresolutions.com/blog/you-should-come-drupalcamp-colorado-june-11-12-2011 <p>Drupalcamp Colorado 2011, co-hosted with Commerce Camp, is shaping up to be another amazing event.</p> <p><a href="http://2011.drupalcampcolorado.org/"><img src="http://growingventuresolutions.com/gvsfiles/dc-colorado.png" alt="Drupalamp Colorado Yeti" /></a></p> <p>In 2010 we had 312 people registered, delicious breakfast and lunches, 2 parties, all for less than $50 in attendance fee. For 2011, we have all that and more. You may consider <a href="http://2011.drupalcampcolorado.org/register">registering</a> before reading the rest...but if you still need to be convinced:</p> <h3>Drupal Camp Colorado: An Amazing Value in 2011</h3> <p>Session submission is closed and session selection is under way, but BOFs will be managed online in the lovely <a href="http://usecod.com/">Conference Organizing Distribution</a> based BOF manager which was used for <a href="http://chicago2011.drupal.org/">Drupalcon Chicago</a> and is being enhanced as it <a href="http://drupal.org/node/1034482">makes it's way into COD</a>.</p> <p>And the <a href="http://2011.drupalcampcolorado.org/program/sessions/accepted">sessions accepted</a> are looking amazing. There's a good mix of the best-of Drupalcon Chicago combined with what will certainly become favorites at Drupalcon London.</p> <p>The content team has made sure that we cover all skill levels this year. Some particularly new user friendly options include:</p> <ul> <li><a href="http://2011.drupalcampcolorado.org/training">Pre-camp training</a> on Friday the 10th from Lullabot and Chapter 3 will give you a 1 day trip forward a few levels in your Drupal journey.</li> <li><a href="http://2011.drupalcampcolorado.org/sessions/getting-started-drupal">Getting started with Drupal</a> will show off the basics and fields. Follow that up with <a href="http://2011.drupalcampcolorado.org/sessions/introduction-views-drupal-7">Introduction to Views</a> and then <a href="http://2011.drupalcampcolorado.org/sessions/how-setup-drupal-development-environment-windows">Setting up a Drupal Development Environment on Windows</a> before heading off to <a href="http://2011.drupalcampcolorado.org/sessions/introduction-drupal-theming">Introduction to Theming</a> and <a href="http://2011.drupalcampcolorado.org/sessions/introduction-module-development">Introduction to Module Development</a>. That takes a solid programmer from newbie to rockstar in a day!</li> </ul> <p>And if you're looking for <strong>socializing</strong> then there are both formal and informal activities to keep you busy. Friday and Saturday nights we'll have official parties at nearby venues with subsidized refreshments.</p> <h3>Amazing Attendees for Drupal Camp Colorado 2011</h3> <p>For 2011 we currently have 185 attendees registered about a month before the camp begins and we have space for up to 500. Among the people planning to come are:</p> <ul> <li>Approximately 25 total <a href="http://growingventuresolutions.com/blog/contributors-drupal-7-final-numbers">Drupal 7 core contributors</a> will be at the camp including some amazingly profilic ones like Damien Tournoud, Károly Négyesi (chx), Dave Reid, Larry Garfield, Bojhan, Nathan Haug (quicksketch) and Randy Fay who combined were responsible for approximately 13% of the code changes in Drupal 7. These are the people who are largely responsible for the new Database API, Image handling in core, automated testing and CCK in core among many other things.</li> <li>Amazing Drupal contributed module maintainers like Earl Miles (merlinofchaos) of Views, Panels, and Nodequeue fame (Nodeque being co-maintained by GVS team member Ezra Barnett Gildesgame).</li> <li>Nathan Haug who maintained many of the image related modules in Drupal 6 and who maintains the Webform, Flag and Fivestar modules (Fivestar being co-maintained by GVS team member Ezra Barnett Gildesgame).</li> <li>Ryan Szrama of Ubercart/Commerce fame who will be here for a whole week in advance of the camp working with the broader <a href="http://www.commerceguys.com/resources/news/drupal-commerce-beta3-released">Drupal Commerce team for a sprint</a>. </li> <li>Dave Reid, who along with me, helps maintain the Pathauto and Token modules. Dave also maintains Path Redirect and about 100 modules total!</li> <li>A few Drupal 8 <a href="http://drupal.org/community-initiatives/drupal-core">initiative owners</a> will be using this as a time for a sprint. Greg Dunlap, David Strauss, and Earl Miles are planning to attend and work on configuration management. Larry Garfield will be there to work on Web services/Context.</li> <li>From Aten Design Group we have Scott Reynen who has been tearing up the <a href="http://drupal.org/project/issues/search/projectapplications?text=&amp;assigned=&amp;submitted=&amp;participant=sreynen&amp;status[]=Open&amp;issue_tags_op=or&amp;issue_tags=">project application queue</a>, Ken Woodworth who is primarily responsible for the amazing <a href="http://denver2012.drupal.org/">Drupalcon Denver</a> design work.</li> <li>TopNotchThemes will be here with Steph, Chris, and Sheena bringing their usual fun and solid theming skills.</li> </ul> <p>If you ever wanted a time to chat with these folks without fighting with 3,000 other people for their attention, Denver is that time.</p> <p>Sold? Great: <a href="http://2011.drupalcampcolorado.org/register">Register now</a>!</p> http://growingventuresolutions.com/blog/you-should-come-drupalcamp-colorado-june-11-12-2011#comments Planet Drupal DrupalCamp drupalcamp colorado Mon, 16 May 2011 23:25:23 +0000 Greg 1337 at http://growingventuresolutions.com Content inventory and content audit with Views http://growingventuresolutions.com/blog/content-inventory-and-content-audit-views <p>Do you know the exact state of the content in your large Drupal site? Thinking of revamping, redesigning or upgrading your site? If you answered 'no!' to the first question or 'yes!' to the second question, it's time for content audit.</p> <p>In this blog post, I cover the what, why, who, when, where and how's of content audits. I've conducted a few small content audits, and <a href="http://drupal.org/node/1123704">I'm leading a much bigger one, on Drupal.org</a>.</p> <h2>What the heck is a content audit?</h2> <p>The idea behind a <em>content inventory</em> is to determine what content you have and where it lives (the quantitative survey). The <em>content audit</em> is qualitative, where you assess whether it's any good or not, and what needs to change to improve it.</p> <p>Traditionally, content inventories are compiled manually, one page of your site at a time, in some sort of spreadsheet. The content inventory should also include PDFs, images, videos, and utility pages such as checkout and log in pages. Content should be inventoried regardless of whether it's hosted on your site or externally. If it's seen or heard within in your content, it needs to be held accountable.</p> <p>Sites with 5000+ nodes could be auditing using a sampling of nodes that represent each content type, but what if you miss some glaring errors? In those instances, you could provide a small link to all site visitors who can flag the page as needing work (this can be done easily enough in Drupal, using a variety of approaches).</p> <!--break--><!--break--><p>Newsflash! Content audits aren't fun and exciting (unless you're a content geek like I am). They can be really boring.</p> <p>Disc Inventory X for Mac audits the contents and space of your hard drive, displaying the contents as colored squares to represent each file type, and how much space those file types consume. Wouldn't it be great to get this sort of clarity on your site content?</p> <p><a href="http://www.flickr.com/photos/revraikes/3181213420/" title="lab2 by revraikes, on Flickr"><img src="http://farm4.static.flickr.com/3317/3181213420_e8f12257ed_m.jpg" width="182" height="240" alt="Hard disc inventory depicted as colored squares" /></a></p> <h2>Why you should audit your content</h2> <p>Primarily, because it's impossible to be sure of the content quality in large sites, especially those with multiple contributors. When a site is audited, all sorts of oddities will be found, such as unfinished blog posts, unpublished nodes, outdated or inaccurate content, redundancies, content in the wrong place, or content that doesn't meet the organization's style standards/guidelines. (You do have style guidelines, right?). You might also find gaps in your content, e.g. discover that Product A, Product B and Product D was covered extensively, but Product C's listing doesn't include target audience and Product E's description was never written.</p> <p>In <a href="http://www.amazon.com/Content-Strategy-Web-Kristina-Halvorson/dp/0321620062">Content Strategy for the Web</a>, Kristina Halvorson writes</p> <blockquote><p>"If you don't know what content you have now, you can't make smart decisions about what needs to happen next."</p></blockquote> <p>If you want even more reasons why you should conduct a content inventory/audit, the books listed at the bottom of the post give reasons, and more in-depth advice.</p> <h2>Who should do a content audit?</h2> <p>A person who cares about the quality of your site's content, or a content strategist. Sometimes the person who cares becomes the content strategist.</p> <p>It's tempting to ask an intern or a random person in the organization who has free time to do, but it means the job may never get done, or done haphazardly, especially if they think they know the content really well. As with QA and user testing, content auditing is often better done with fresh eyes; someone outside the organization.</p> <h2>When to do a content audit</h2> <p>Ideally, you'll complete the audit before:</p> <ul> <li>Reorganizing your current site structure </li><li>Upgrading to a new version of Drupal or (oh noes!) migrating to a different CMS </li><li>Adding new content types </li><li>Making content decisions based on your site's SEO performance </li></ul> <p>If a site were migrating <em>to</em> Drupal, a content audit could be performed after the migration, but before key decisions about site architecture, IA/hierarchy, navigation/menus and publishing workflows are finalized.</p> <p>Like any website project, the more organized and informed you are, the more likely your project will be a success.</p> <h2>Where to do a content audit</h2> <p>I don't mean, "Should I be in the 3rd floor conference room, or should I be at my desk?" I mean, where should you store the content audit's data?</p> <p>The probem with constructing your content audit in a spreadsheet is that when the content audit is revisited 6 months later, it's going to be out of date—what a drag!</p> <p>The standard Drupal administrative content overview page at admin/content/node/overview doesn't allow you to add more columns or sort by column heading; the overview page alone isn't sufficient.</p> <h2>Roll your own inventory with Views</h2> <p>Here's a recipe, using Views 2 in Drupal 6 to (mostly) painlessly create your content inventory.</p> <p><img src="http://growingventuresolutions.com/gvsfiles/content-audit/inventory.png" alt="Screenshot of a content inventory" />The content inventory will be a like a spreadsheet, with columns listing information for each of your nodes.</p> <h3>Preparation for the content audit</h3> <ol> <li>Ensure Views 2 is installed and enabled </li><li>Enable core Statistics module (optional) </li><li>You may want an administrative theme enabled; the table view of the View is going to get wide, and you don't want to try to decipher squished columns. Otherwise, just ensure the blocks or other page elements don't display on the inventory page. </li><li>You can use the <a href="http://drupal.org/project/annotate">Annotate module</a> to store editorial or "what needs doing" notes about each node. </li><li>You can use flags to flag notes as needing a particular type of work. </li></ol> <p>I'll cover annotations and flags in depth, in a future blog post about the <a href="http://drupal.org/project/content_audit">Content Audit module</a>, which will package a content audit View and other tools for quicker inventories.</p> <h2>Building the view</h2> <p>First, create a new View and call it something like 'node_content_inventory'.</p> <h3>Basic settings</h3> <p>Title: [Your site name] Node Content Inventory<br /> Style: Table<br /> Access: administer nodes (or perhaps you want to use your Admin role for access)</p> <p>Having long pages is desirable once you start resorting and filtering. If you have a couple hundred nodes, you can avoid using pagers, so set it to 'No' with Items per page as Unlimited.</p> <p>Otherwise, display 200 items or so per page and enable the full pager.</p> <p>In the Table styles options, ensure every field is marked as sortable. Unfortunately, you can't sort by path.</p> <p>(If you're using Book content, you should include the depth too! But unfortunately, there isn't a default way to display the parent of each book node.)</p> <p><a href="http://growingventuresolutions.com/gvsfiles/content-audit/auditview.png"><img src="http://growingventuresolutions.com/gvsfiles/content-audit/auditview-sm.png" alt="Screenshot of view edit screen" /></a></p> <h3>Fields to display</h3> <p>Node: Nid Nid<br /> Node: Title Title<br /> Node: Path Path<br /> Node: Type Type<br /> Node: Published Published<br /> Node: Updated date Updated date<br /> Node: Post date Post date<br /> User: Name Author<br /> Node statistics: Total views Total views<br /> Book: Depth Depth</p> <p>These will produce the site's basic content inventory. The above are just suggestions; feel free to add more if you want to evaluate different fields.</p> <p>Create a Page display and give it a path such as 'node-content-inventory'.</p> <h3>Filters</h3> <p>Next, you'll want to filter out content that isn't relevant to your content inventory. Let's say you want to audit everything on your conference site apart from Room and Time slot nodes.</p> <p>Create a Node: Type filter, only including the content you want to audit. Then expose the node Type filter. You may want to create and expose other filters, depending on your needs.</p> <p><a href="http://growingventuresolutions.com/gvsfiles/content-audit/views-limit-nodetype.png"><img src="http://growingventuresolutions.com/gvsfiles/content-audit/views-limit-nodetype-sm.png" alt="Views edit screen" /></a></p> <p>A manually-constructed content audit would include which section the site is in. So, if your site's sections are generated by taxonomy term, you should also include this taxonomy field in its own sortable column in the View.</p> <p>Ideally, the node paths would be sortable with an exposed filter, but that will require writing a Views handler. It's on the To Do list!</p> <p>In the header text, include the date and month the content will be reviewed, and update it each time you re-evaluate your content. (Every 6 months, right?)</p> <p>Finally, save the view (actually, you should probably be saving as you're constructing it).</p> <h2>Evaluating the content</h2> <p>Look at your page at node-content-inventory. It's a giant list of all your nodes.</p> <p>Now what? You have options.</p> <ul> <li>Option A (Export): export this view to CSV and manage your content audit in spreadsheet software or Google Docs. The <a href="http://drupal.org/project/views_bonus">Views Bonus Pack</a> module will let you export the view as a CVS file.<br /> Pro: Less data to store in your database<br /> Con: Your inventory is almost immediately outdated; will be extra time-consuming to update on a regular basis</li> <li><a name="opt-b">Option B (Flags)</a>: 'Flag' content that needs to be updated using the <a href="http://drupal.org/project/flag">Flag module</a>. You can adjust the flag settings so that only certain roles can use this flag, and then set which content types can be flagged (or set it as global). You can then add the Flag to the content audit view, and/or create a separate view of nodes that have been flagged. However, marking something as "needs work" doesn't provide enough detail, so you'll want to record notes somehow (see Option C). You can create additional flags for each type of action to be taken, e.g. "needs style review" or "redundant", without the casual visitor even knowing, while keeping your content team in the loop.</li> <li>Option C: Keep 'audit notes' field on each content type in Drupal site database with the Annotate module or by creating a field on the nodes.</li> <li>Option D: Use the Content Audit feature module, which constructs the View, and will soon have configured Annotation (this hasn't been built yet).</li> <li>Option E: Create another node type called Audit notes, and once filled in, then nodereference the node it covers. Then, it's easy to build a view of the Audit notes (I'm also wondering whether this could be a custom bit of code to automagically do this, then include in the Content Audit module).</li> </ul> <p>Option C and D are great, because you're not reinventing the wheel every time you review your content inventory.</p> <h3>Content inventory for files and other non-node content</h3> <p>For files, such as images or PDFs attached to nodes, you might want to create a separate View and call it file_content_inventory. You could combine it with your primary node content audit, but the headings are different.</p> <p>Other non-node content, such as landing pages created with Panels, Views, tpl.php or things like login pages need to be audited manually.</p> <h3>1, 2, 3... Audit!</h3> <p>Now the fun begins. Read existing content and check the following (and you may want to include extra instructions for your reviewers, if it isn't you doing the work).</p> <ul> <li>Does it contain redundant info (is this content covered elsewhere? note down the node ID where it is covered)</li> <li>Is it in the wrong place (does another page make more sense?)</li> <li>Does the content need restructuring? Provide examples.</li> <li>Is it inaccurate? Don't spend time researching the inaccuracies, but if you think the content is inaccurate, let's say so.</li> <li>Is it useful? Does it add value? Or just wasting people's time? Just because it exists, doesn't mean it should be kept around.</li> <li>Does it need language (grammar, spelling etc) improvements?</li> <li>Does the tone and style meet the guidelines? <a href="http://drupal.org/contribute/documentation/guide/style" title="http://drupal.org/contribute/documentation/guide/style">http://drupal.org/contribute/documentation/guide/style</a></li> <li>Is it written for the right audience?</li> <li>Is there any key information that's missing?</li> <li>Does the url path not make sense? As a top level or important page, does it need it's own path?</li> <li>Could the content be supported by an image or illustration? If yes, what?</li> </ul> <p>This process could take weeks or months, depending on many factors.</p> <h3>Summary</h3> <ul> <li>Content audits. They're important. Do them.</li> <li>If you don't want to do the audit yourself, find someone who can. Hire an information architect or content strategist.</li> <li>Take the time to improve your content based on the audit. People come to your site for the great content.</li> </ul> <p><img src="http://growingventuresolutions.com/gvsfiles/content-audit/process.png" alt="process" /><br /> Content audit process: Start > Decide what needs auditing > Configure tools for auditing > Evaluate content > ??? > Profit!!</p> <p>The '???' is where you (or your content strategist and writers) do the magic of identifying and fixing content problems. After that, your site will reap the benefits.</p> <p>Now, I'm interested if anyone has done content audits using Views or other modules, and what your experiences it it were! Please drop some knowledge in the comments below.</p> <h4>Additional Reading</h4> <p><a href="http://www.amazon.com/Content-Strategy-Web-Kristina-Halvorson/dp/0321620062">Content Strategy for the Web</a>, by Kristina Halvorson, particularly Chapters 4 and 12</p> <p><a href="http://www.abookapart.com/products/the-elements-of-content-strategy">The Elements of Content Strategy</a> by Erin Kissane</p> <p><a href="http://www.amazon.com/Information-Architecture-World-Wide-Web/dp/0596527349/ref=sr_1_1?ie=UTF8&amp;qid=1302490924&amp;sr=8-1">Information Architecture for the World Wide Web</a> by Peter Morville and Louis Rosenfeld</p> <p><a href="http://www.amazon.com/Project-Guide-Design-experience-designers/dp/0321607376/ref=sr_1_1?ie=UTF8&amp;s=books&amp;qid=1302490978&amp;sr=8-1">A Project Guide to UX Design</a> by Russ Unger and Carolyn Chandler</p> http://growingventuresolutions.com/blog/content-inventory-and-content-audit-views#comments Planet Drupal content strategy views Sun, 10 Apr 2011 06:36:00 +0000 lisa 1248 at http://growingventuresolutions.com Mediacurrent Interviewed about COD on UseCod.com http://growingventuresolutions.com/blog/mediacurrent-interviewed-about-cod-usecod-com <p>Dave Terry from Drupal development shop <a href="http://mediacurrent.com/">Mediacurrent</a> spoke to GVS about Mediacurrent's latest Conference Organizing Distribution site implementation for the Pegaworld 2011 conference. You can <a href="http://usecod.com/news/2011/mediacurrent-talks-about-their-latest-cod-implementation">read the whole interview at UseCod.com</a>.</p> <p><a href="http://usecod.com/news/2011/mediacurrent-talks-about-their-latest-cod-implementation"><img src="http://growingventuresolutions.com/gvsfiles/cod-sticker-3.png" /></a></p> http://growingventuresolutions.com/blog/mediacurrent-interviewed-about-cod-usecod-com#comments Planet Drupal cod mediacurrent Wed, 06 Apr 2011 20:42:05 +0000 Ezra 1295 at http://growingventuresolutions.com Branding Exercise Leaves Fish Dead, Owl Satisfied, Drupalers sad http://growingventuresolutions.com/blog/branding-exercise-leaves-fish-dead-owl-satisfied-drupalers-sad <p>A routine branding exercise went awry early Friday in Brooklyn when Growing Venture Solutions performed a <a href="http://growingventuresolutions.com/gvsfiles/cod_scout_mindmap_0.png">"mind map"</a> exercise to aid in the creation of logos for two of their flagship products, the <a href="http://drupalscout.com">Scout hosted sercurity review service</a> and <a href="http://usecod.com"/>COD, the Conference Organizing Distribution for Drupal</a>.</p> <p><img src="http://growingventuresolutions.com/gvsfiles/scout-logo-3.png" alt="Drupal Scout Logo" stlye="float:left;" /><img src="http://growingventuresolutions.com/gvsfiles/cod-sticker-3.png" alt="Conference Organizing Distribution logo" style="float:right;" /></p> <p>"Connecting to the unintellectualized, visceral, gut responses we get from each logo helps us maximize branding potential so that we can produce marketing collateral that's sure to engage members of our target market segments, helping them to connect to each brand at an emotional level, which results in increased conversions" said social media expert Robert H. McJellyPants. He added, "Tachyon converter beam subspace electron resonance tuning."</p> <p>Unfortunately, while exercise participants were discussing their friendly, communal associations with schools of smiling fish in the COD logo, as well as some of the more stern, defensive associations evoked by the Scout owl logo, the owl took flight and picked up the fish, instantly crushing the fish's vital internal organs with its beak.</p> <p><img src="http://growingventuresolutions.com/gvsfiles/scout-meets-cod-1.png" alt="Scout owl logo eating COD fish logo" /><br /> Illustration by Carl Wiedemann.</p> <p>Needless to say, participants were horrified at the sudden attack by the owl but impressed by its swift, decisive action in the face of what the owl saw as a potential security risk to its personal website, SupercuteCatsWearingWigsandSmallDressesTailoredEspciallyforCatsNoThisisnotajoke.com/website.</p> <p>McJellypants expressed concern, saying "This is highly unusual for a branding exercise, and the attack could be a step in the wrong direction for both brands. It may cause people to construe the owl as reckless and aggressive, rather than defensive and wise." He pointed out that "[i]t makes the COD logo more similar to the previous one, which was also a dead fish," referring to the public domain image of an Atlantic cod that previously represented the Conference Organizing Distribution.<br /> <img src="http://growingventuresolutions.com/gvsfiles/Atlantic_cod-1.jpg" alt="Dead Atlantic cod" /></p> <p>COD has been used to power many <a href="http://usecod.com/showcase">feature-rich conference websites</a> for DrupalCamps, the recent DrupalCon Chicago conference, as well as non-Drupal events in the United States, India and Australia.</p> <p>When asked to justify the attack, the owl provided participants with helpful information about the specific security vulnerability it claimed was presented by the fish. However, for more information, it directed them to its <a href="http://drupalscout.com/products/scout-automated-plus">"Scout Automated Plus"</a> and <a href="http://drupalscout.com/products/scout-enterprise">"Scout Enterprise"</a> solutions, where Drupal security experts explain potential vulnerabilities on specific sites—and the steps to mediate them—in great detail.</p> <p>Despite having clear expertise in Drupal security, it was reported in several tweets on Friday that the owl's personal site had the full HTML input format enabled for anonymous commenters early Friday morning. The issue appears to be resolved as of the publication of this article, though one comment on the site by "IttyBittyPrettyWittyKittyCommitteeinNewYorkCitySingingaDitty36" appeared to show a properly escaped cross-site scripting attack probe, and read, &lt;script&gt;alert('XSS Vulnerable Meeeeow');&lt;/script&gt;</p> <p>When reached for comment, the owl tried to bite off my face.</p> <p>Two of the mind-map exercise attendees posted a re-enactment of the event to YouTube. <em>Note: the mind map was done <strong>on a boat.</strong></em></p> <p><iframe title="YouTube video player" width="480" height="390" src="http://www.youtube.com/embed/rphGU2Ktmtg" frameborder="0" allowfullscreen></iframe></p> http://growingventuresolutions.com/blog/branding-exercise-leaves-fish-dead-owl-satisfied-drupalers-sad#comments Planet Drupal conference organizing distribution Drupal Scout event management marketing security Fri, 01 Apr 2011 15:24:20 +0000 Ezra 1288 at http://growingventuresolutions.com Drupal 7 release parties and December sprints http://growingventuresolutions.com/blog/drupal-7-release-parties-and-december-sprints <p>GVS has had a busy December and great start to 2011!</p> <h2>NYC and Denver Drupal 7 release parties</h2> <p>The NYC Drupal 7 Launch Party, hosted by Growing Venture Solutions, Treehouse Agency, and ThinkDrop took place on January 7, 2011.</p> <p>We were delighted at the turnout and enthusiasm for Drupal 7!</p> <p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-crowd.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-crowd.jpg" alt="Crowd of attendees" /></a><br /> Happy crowd!<br /> </p> <p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-group.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-group.jpg" alt="Group photo of organizers and speakers" /></a><br /> The speakers were Rob Purdie (Economist), Todd Ricker (New York Stock Exchange) and Thomas Turnbull (Zagat). The organizers were Lisa Rex, Claudina Sarahe, Ezra Gildesgame, Amy Cham and Ben Jeavons.</p> <!--break--><!--break--><p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-dries-skype.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-dries-skype.jpg" alt="Photo of Dries on Skype" /></a><br /> We did a video link up with the Boston party. Oh look, it's Dries Buytaert!<br /> </p> <p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-denver-skype.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-denver-skype.jpg" alt="Photo of Greg Knaddison and Kevin Bridges on Skype" /></a><br /> And then we did a video link up with the Denver and Austin parties. Everyone say hi to Greggles and Kevin Bridges!<br /> </p> <p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-jacob.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-jacob.jpg" alt="Photo of Jacob" /></a><br /> And Jacob Redding wore his Drupal suit and tie!<br /> </p> <p><a href="http://growingventuresolutions.com/gvsfiles/d7rp-raffles.jpg"><img src="http://growingventuresolutions.com/gvsfiles/d7rp-raffles.jpg" alt="Photo of giving prizes away" /></a><br /> We gave away raffle prizes from Lullabot, Packt Publishing and Mastering Drupal, and there was some additional sponsorship support from CivicActions and Bluestocking Collective.</p> <p>The official photographer for the NYC Drupal 7 party was <a href="http://www.mattcham.com">Matt Cham</a>. Additional <a href="http://www.flickr.com/photos/treehouseagency/tags/d7rpnyc">d7rp_nyc party photos</a> are on Flickr.</p> <p>GVS also co-hosted the Denver party, with Greg Knaddison in attendance. The next three photos are by Keith Stansell.</p> <p><a href="http://www.flickr.com/photos/sole_i/5335033688/in/set-72157625647129263/"><img src="http://farm6.static.flickr.com/5125/5335033688_f2a3162117.jpg" alt="Danomanion, Andrea, Aaronnott, Greggles, Justin Christoffersen and friend" /></a><br /> Dano Manion, Andrea, Aaron Nott, Greg Knaddison and Justin Christoffersen. I'm holding up a nice <a href="http://certifiedtorock.com/">Certified to Rock</a> sticker ;)</p> <p><a href="http://www.flickr.com/photos/sole_i/5334889102/in/set-72157625647129263/"><img src="http://farm6.static.flickr.com/5043/5334889102_e4b4f7d1fa.jpg" alt="Matthew Saunders and Andy of Examiner.com" /></a><br /> Andy Packard and Matthew Saunders from the team at <a href="http://www.examiner.com/">Examiner.com</a>.</p> <p><a href="http://www.flickr.com/photos/sole_i/5334269451/in/set-72157625647129263/"><img src="http://farm6.static.flickr.com/5048/5334269451_93b25fd081.jpg" alt="Jyee making Drupal 7 and 7" /></a><br /> Jason Yee making <a href="http://atendesigngroup.com/blog/drupal-7-and-seven">Drupal 7 and Seven</a>.</p> <h2>GVS &lt;3 sprints</h2> <p>GVS and Treehouse sponsored a D7CX code sprint at the offices of GVS neighbor HUGE in Brooklyn, NY.<br /> Progress made at the sprint included working automated tests for the Nodequeue module, a stable Drupal 7 release of the Security review module, <a href="http://groups.drupal.org/node/115009">amongst other work.</a></p> <p><a href="http://www.flickr.com/photos/35549722@N00/5260602391/"><img src="http://farm6.static.flickr.com/5123/5260602391_404b046bce.jpg" /></a><br /> <br /> Ezra, Vikram Yelanadu, Thomas Turnbull, Andrew Morton, Steven Merrill</p> <p>Meanwhile, Lisa participated in the <a href="http://groups.drupal.org/node/105309">Drupal Docs sprint weekend</a> in Vancouver where the core documentation team hashed out directions and problems the Docs team face (see <a href="http://drupal.org/project/issues/search/infrastructure?issue_tags=docsyvr2010">issues tagged docsyvr2010</a> for things that were raised during the meeting). On Saturday, there was a Docs team sprint with special guests chx, dmitrig01, and webchick!</p> <p><img src="http://farm6.static.flickr.com/5208/5253327904_3249d63ef5.jpg" alt="Docs team" /><br /> <a href="http://www.flickr.com/photos/arianek/5253327904/sizes/m/in/set-72157625579478132/" title="http://www.flickr.com/photos/arianek/5253327904/sizes/m/in/set-72157625579478132/">http://www.flickr.com/photos/arianek/5253327904/sizes/m/in/set-721576255...</a></p> http://growingventuresolutions.com/blog/drupal-7-release-parties-and-december-sprints#comments Planet Drupal code sprints d7rp doc sprints documentation Drupal 7 release party Tue, 18 Jan 2011 23:03:53 +0000 Team GVS 1192 at http://growingventuresolutions.com Module owners: How to make your module description useful http://growingventuresolutions.com/blog/module-owners-how-make-your-module-description-useful <p>Here's the scenario: Someone semi-familiar with Drupal is building a site. They need to find a module to meet one of the site's requirements. Since there are over 5000 modules for Drupal 6, it must exist, right?</p> <p>Let's assume they don't know who to ask, so they start researching. To evaluate contributed Drupal modules, the first resource they will use is the module's project node on Drupal.org.</p> <h2>Most important elements of Drupal project pages</h2> <p>What are site builders looking for when evaluating a module? I asked Drupallers via Twitter what they look at specifically and got the following:</p> <!--break--><!--break--> <ol> <li>Who the maintainers are. </li><li>Date of last commit. </li><li>How recent the recommended version is. </li><li>Date of last release. </li><li>Number of open issues. </li><li>Number of commits. </li><li>Usage stats. </li><li>Issue follow-up rate. </li><li>What does the module <em>do</em>? </li><li>Why was the module created? </li><li>What problem is the module trying to solve? </li><li>Is the module generic enough to apply to other problems? </li><li>Is there any documentation? </li><li>Will there be a Drupal 7 version soon? </li></ol> <p>Notice that items 1-7 are provided automatically by the Drupal.org <a href="http://drupal.org/project/project">Project module</a>. And items 9-12 are details that <strong>only the module maintainers can provide within the project's Full description field</strong>.</p> <p>The above details tell a site builder about the activeness and awareness of the maintainer(s), whether the module can be considered reputable because of the names of the maintainers behind the module and hopefully, give them enough info to know whether they should use the module.</p> <p>The folks that responded to my (very non-scientific) survey are all Drupal-savvy. What about the less-than-savvy? The maintainer names won't be meaningful and neither will some of the stats. The emphasis is now on making your module description more useful. Here's a few ideas...</p> <h2>Useful description idea #1: use subheadings</h2> <p>Subheadings make your description more easily scannable. In an ideal world, Drupal module maintainers would adopt a standard for subheading text and sizes. I've seen h2, h3 and strong. Which is the right one?</p> <p>Here's a list of subheadings that would be awesome. I'll describe them fully below.</p> <ul> <li>Overview</li> <li>Features</li> <li>Requirements</li> <li>Known problems</li> <li>Tutorials</li> <li>Pledges</li> <li>Credits</li> <li>Recommended modules</li> <li>Similar projects</li> </ul> <h2>Useful description idea #2: Write a good overview</h2> <p>Try to answer the following questions in 5 sentences or less: What does your module do? What's it trying to solve? Who is the module for/who is the audience? This reduces time wasted and also, if you can confidently tell someone this module is for them, they're more likely to use it and support it. And if it's easier to describe with pictures, go for it (see Idea #7).</p> <p>Greggles likes to include version notices too, e.g. "Version 6.x-2.x dev is not stable and probably won't be for a year or more. It is the home of new experimentation and crazy new features. Version 7.x-1.x-dev is a direct port of the 6.x-2.x-dev and will be the stable version for Drupal 7. There will be no direct port of 6.x-1.x-dev" etc.</p> <p>It's all about managing expectations!</p> <h2>Useful description idea #3: Summarize features</h2> <p>This should be a bulleted list of features to help people quickly figure out if it's useful to them. Keywords will also be useful when folks are searching. Both <a href="http://drupal.org/project/filefield">FileField</a> and <a href="http://drupal.org/project/imce">IMCE module</a> do the feature list well.</p> <p><a href="http://growingventuresolutions.com/gvsfiles/imce-desc.png"><img src="http://growingventuresolutions.com/gvsfiles/imce-desc.png" alt="Tell us why your module rocks!" /></a></p> <h2>Useful description idea #4: Include requirements</h2> <p>Include module or library dependencies as well as any other technology requirements, e.g. PHP5. <a href="http://drupal.org/project/filefield">FileField</a> does this. Why? Because like any recipe, it helps to know what ingredients you need upfront, before you're waist-deep!</p> <p><a href="http://growingventuresolutions.com/gvsfiles/filefield-desc.png"><img src="http://growingventuresolutions.com/gvsfiles/filefield-desc.png" alt="Features and requirements spelled out in the admin menu description" /></a></p> <h2>Useful description idea #5: Share known problems</h2> <p>If there are conflicts, incompatibilities, extremely common bugs, or gotchas that are easy to miss, be upfront about it. Briefly describe the problem, link to the issue (so others can contribute), and you should see a reduction on the number of duplicate issues that are created.</p> <p><a href="http://growingventuresolutions.com/gvsfiles/imce-known.png"><img src="http://growingventuresolutions.com/gvsfiles/imce-known.png" alt="screenshot of IMCE's known issues" /></a></p> <h2>Useful description idea #6: Credit sponsors and maintainers</h2> <p>If any organization in some way sponsored work on the module, link them! It extends credibility, and it furthers the notion that modules can be sponsored. Imagine how great it would be to have more of your module work sponsored (that is, your time is compensated in some way). If organizations see the benefit of sponsoring, in the form of free advertising and community karma, especially as a module's popularity grows, they'll be more inclined to sponsor future projects, and can endorse sponsoring to other companies.</p> <p>Also, let's not forget co-maintainers. Since "ownership" of modules usually changes over time, co-maintainers names and other history are useful to have recorded here.</p> <p><a href="http://growingventuresolutions.com/gvsfiles/adminmenu-desc.png"><img src="http://growingventuresolutions.com/gvsfiles/adminmenu-desc.png" alt="Features and requirements spelled out in the admin menu description" /></a></p> <h2>Useful description idea #7: Create and list tutorials</h2> <p>In addition to the Documentation link provided by the Project node, a list of blog posts, demos, screencasts, screenshots, reviews, and any other resources should be listed here. Smaller projects probably won't be written up in blog posts, but having a list of the ways one can learn how to use your module is very helpful, especially at a time when they're getting frustrated.</p> <p>You can help a newbie a ton if you create a short screencast showing the typical usage and configuration. If you're not up for making a screencast, provide embedded (or linked) screenshots of the module configuration and module in action.</p> <h2>Useful description idea #8: Pledges</h2> <p>If you've taken the D7CX, D7AX and any other pledges, list them.</p> <h2>Useful description idea #9: Acknowledge other projects</h2> <p>Yes, the <a href="http://drupal.org/project/pivots">Pivots</a> already lists Related projects, but it's not quite the same as Recommended modules. If your module works particularly well with other modules, list them here.</p> <p>Likewise, if you're aware of modules similar to yours, feel free to add them or link to a node in the <a href="http://groups.drupal.org/similar-module-review">Similar Module Review group</a> or this issue on the <a href="http://groups.drupal.org/node/20384">myriad Tabs and Slideshow modules</a>.</p> <h2>Oh noes! This description is too long!</h2> <p>Of course, if your project page is too long, you risk overwhelming readers and/or losing their interest. If you have a lot to say, consider linking to your detailed README.txt in addition to creating module documentation. <a href="http://drupal.org/node/161085">Module documentation guidelines</a> are provided in the Drupal.org handbook.</p> <p>People will love you forever if you provide awesome documentation in the form of screenshots, screencasts and a well-written Documentation node.</p> <h2>What next?</h2> <p>If you think it's a nice, considerate gesture to not waste people's time by clarifying your module's benefits, requirements and current issues, let us know.</p> <p>We're interested in hearing what others think. Is this something we can encourage on Drupal.org? What other info and subheadings should be included?</p> <p>The end goal is for me to create a Documentation node drupal.org to describe these best practices for module descriptions.</p> <p>Many thanks to <a href="http://www.twitter.com/arianesays">@arianesays</a>, <a href="http://www.twitter.com/decibelplaces">@decibelplaces</a>, <a href="http://www.twitter.com/deviantintegral">@deviantintegral</a>, <a href="http://www.twitter.com/dmitrig01">@dmitrig01</a>, <a href="http://www.twitter.com/joelfarris">@joelfarris</a>, <a href="http://www.twitter.com/jpoesen">@jpoesen</a>, <a href="http://www.twitter.com/stevenmerrill">@stevenmerrill</a>, <a href="http://www.twitter.com/greggles">@greggles</a>, <a href="http://www.twitter.com/ezrabg">@ezrabg</a> and <a href="http://www.twitter.com/benswords">@benswords</a> for contributing to this post via Twitter!</p> <h2>P.S. If this sounds good to you...</h2> <p>Use this handy cut and paste skeleton to flesh out your project description!</p> <p><div class="codeblock"><code>&lt;h2&gt;Overview&lt;/h2&gt;<br /><br />&lt;h2&gt;Features&lt;/h2&gt;<br /><br />&lt;h2&gt;Requirements&lt;/h2&gt;<br /><br />&lt;h2&gt;Known problems&lt;/h2&gt;<br /><br />&lt;h2&gt;Tutorials&lt;/h2&gt;<br /><br />&lt;h2&gt;Pledges&lt;/h2&gt;<br /><br />&lt;h2&gt;Credits&lt;/h2&gt;<br /><br />&lt;h2&gt;Recommended modules&lt;/h2&gt;<br /><br />&lt;h2&gt;Similar projects&lt;/h2&gt;</code></div></p> http://growingventuresolutions.com/blog/module-owners-how-make-your-module-description-useful#comments Planet Drupal Information Architecture Writing for the web Mon, 13 Dec 2010 14:34:09 +0000 lisa 1170 at http://growingventuresolutions.com