117 The Drupal Project Application Process with Jeremy Rasmussen - Modules Unraveled Podcast

Modules Unraveled Podcast

## Project

It’s easier than you think to publish your module on Drupal.org. This is my experience going through the entire process. Sharing this experience I hope to convince you and others to do the same. Contributing back to the community that gives all of us so much, to many of us our livelihood.

* When Doug first recommended that I talk to you about this, I wasn’t really thrilled. But, I took a look at your slides, and thought that it actually looked like really good information. So, what made you decide to put together a presentation on the project application process in the first place?

My “Why”

Finally published a module to help solve my own problem

My project that took me through this process is Display Suite Extra Layouts

https://www.drupal.org/project/ds_extra_layouts

Projects don’t have to be the 100% perfect solve for everyone, everywhere

It’s more about: Giving back, centralizing code, helping others make great projects too.

* So what are the steps to getting a project reviewed and accepted?

Where to start and basically the entire guide to submitting a module

“Apply for permissions to create full projects” https://www.drupal.org/node/1011698

Some things to know

One time process

Reviews are primarily by your peers

Learns/reiterates code standards and best practices

Do your Research First

Check if your idea exists already

Combine efforts where you can

Volunteer as a co-maintainer where needed

* Okay, let’s get down to the nitty-gritty. What are the technical steps you need to follow to get your project approved?

Setup Git Access

Learn some Git basics

Google is your friend

Github & Code School’s tutorial http://try.github.io

Setup your Git Access in your D.o profile

Basically just need to add an SSH key

Instructions here: https://www.drupal.org/node/1047190

Sandboxes

With Git access setup you can now create sandboxes or “experimental” projects

Instructions here: https://www.drupal.org/node/1011196

Take advantage of these, having a commit history of changes is a good thing.

Use sandboxes to get your code “production ready”

The Checklist (Pre-Application)

Before starting the application make sure you run through the checklist

Setup Readme, Git Branches, well commented, etc...

Link to checklist: https://www.drupal.org/node/1587704

The process goes much much faster, many people skip it

PA Review Bonus

Part of the checklist asks you to run your sandbox through a bot.

Catches the majority of problems.

You can setup your own Review Bot

https://www.drupal.org/project/pareviewsh

http://pareview.sh/

“Full Stop” - Took me a while to figure that out.

You get a review bonus when everything is fixed.

The Application

https://www.drupal.org/project/issues/projectapplications

READ THE DIRECTIONS!

In the title include core version: [D7]

Write a Clear Descriptions… can be the same as your project/sandbox page

Clear descriptions help people understand better the purpose of your project

Provide links to your Sandbox, the Git clone command, and PA Review

When you are ready set the status to “Needs Review”

* I noticed when I looked through your slides that you mentioned reviewing other projects as a part of this. Why is that needed?

Reviewing other projects

You must review at least 3 other people’s projects

Post a link to your reviews in your own project application

It’s just like trying a new module.

Download it, enable it, try it

Report back your findings… good, bad, and suggestions

I learned a lot from doing this

Now you wait.

Others will review your project and post feedback.

be prompt to fix issues

Once all is well someone should mark your project “Reviewed and Tested by the Community”

Then you wait for someone with the “Power” to grant you full project status

* Once someone has approved your project, what’s involved with getting the official project page setup?

Into the Wild!

You can now create your project page

be mindful of your project URL, you can’t change it

Create a new release on your project page and in Git

Creating a release: https://www.drupal.org/node/1068944

Tag Nameing Convention: https://www.drupal.org/node/1015226

FIN.

## Questions from Twitter

* [timani.co.zw](http://twitter.com/timani_net)

Will this cover D.O vs github for projects? Pros & cons of staying with current design vs migrating to github?

* [Joshua Turton](http://twitter.com/sjinteractive)

#MUP117 When are we going to see movement on the project application issue queue?

* [Joshua Turton](http://twitter.com/sjinteractive)

#MUP117 process seems broken - have to apply... but once past "quality control" you can release any junk u want.

* [Joshua Turton](http://twitter.com/sjinteractive)

#MUP117 Also: encouraged to review others to boost your app's priority, but why would we trust reviews from users who haven't passed through process? (speaking of high priority list/review bonuses)