This issue is an RFC from d.o admins

As part of the new CVS applications process I believe we need documentation on:-

  1. What applicants can expect from the reviewers.
  2. Guidelines for reviewers on what to look for during a review.

I've started a page at the following URL (which is unpublished until we can agree here on what's useful).

http://drupal.org/node/539608

Comments

greggles’s picture

Those look sane to me. I suggest that we be a bit more permissive of forks/improvements if the author has a solid justification.

avpaderno’s picture

Forks could be accepted if there is a solid justification (which means it should not be "I find the module difficult to use"), and if the quality level is at least the same than the original code.

How much solid a justification is risks to be a subjective criterion. As first module, I would expect an original module, in someway; still, I would not want to block too much people from contributing on Drupal.

AjK’s picture

Then I think we need to define "fork" better then. For example, UC isn't a fork of EC but taking an existing module and tinkering it a bit is basically a unacceptable fork to me.

gerhard killesreiter’s picture

There are several such modules on d.o, what do you propose to do with them?

Once the author is past the cvs "barrier" they can create any project they want anyway, with or without originality.

avpaderno’s picture

It's true that after being approved they can create any kind of projects; still, it would be better if they would not be allowed to create a module/theme by taking code from another module (or making a patchwork with code of different modules) at least while applying to get CVS access.

I also agree to not make the application process to difficult for who wants to contribute; they should, anyway, show they know a minimum of Drupal to write a module as it is supposed to be.

michelle’s picture

Unfortunately, I think you'll just open a can of worms if you get into the whole "no dupes/forks" thing. I'm to the point where I just don't care anymore. I'm pinning my hopes on the redesign making it easier to sort through the module mess because those of us who think it's better to work together are in the minority.

Otherwise it sounds fine.

Michelle

AjK’s picture

Well, we can drop the bullet point for the fork and just rely on "Your module or theme should demonstrate ingenuity and originality by the author." to give us the option on a case by case basis?

gerhard killesreiter’s picture

That sounds better and is esier to apply.

michelle’s picture

Yeah, I like that better.

Michelle

AjK’s picture

ok, dropped that bullet point.

Any other thoughts as to what should be there or is that enough?

avpaderno’s picture

I think the most important points are already present (security, Drupal API, coding standards); other aspects should be taken in consideration on a case by case basis.

AjK’s picture

Status: Active » Fixed

published.

heine’s picture

Status: Fixed » Active

There's to much focus on the coding standards at the moment. This has the following problems:

- finding specks, missing beams
- very negative and tedious for the CVS applicant (and the reviewer I'd think).

Since when is following the coding standards to the dot (literally) a requirement?

Note, if indentation is wrong or the style makes the module effectively unreadable I do think CVS access should not be granted before the style is fixed. A few errors here and there should not be the reason for stalling CVS access. Perhaps just point out the standards, and continue the procedure?

killes@www.drop.org’s picture

totally agree

avpaderno’s picture

The coding standards include also the respect of the module namespace.
There are points in the coding standards that are not merely about the aspect of the code; still, how the code is formatted has its weight, especially because other people could contribute a patch for a problem they found (and trying to fix code that has its particular format is very difficult).

To make a comparison with applying for a driving license, when I take a road test I am valued for many details; when I have a driving license, I can drive using one hand, but that is not something I do on a road test (if I want to have the driving license).
I am not saying that a CVS application has the same importance of applying for a driving license, indeed.

Pointing out to the documentation, and continuing the procedure could not have the desired effect; once obtained the CVS account, it's probable that the applicant forgets what suggested to do (why should he care? He has access to the CVS...).

Maybe I misunderstood the principal points to review in the code, but I remember they were at least secure code, and respect for the coding standards.

AjK’s picture

When previously reviewing cvs apps I wasn't too concerned about the coding standards to the Nth degree. All I was interested in was the applicants appreciation of the API and security issues, ingenuity and originality. I only declined on the grounds of the coding standards when the code was just unreadable from the review point of view. But that was back in the days when it was just me and my time and that dictated how much effort I could put into each review.

Now we have the issue queue system so in theory a better review should be possible. However, I don't think the review issue queue should be used so heavily as a "learning centre" for newbies. Sure, there's plenty of possibilities for newbie FAQs derived from the info there but I think I'd rather see a more relaxed review and not raise the bar too high. It's worth remembering that once an app is approved the applicant will get their own project issue queue and face the music there too!

I'm fine with leaving the part about the coding standards at http://drupal.org/node/539608 to continue applicants to follow it but I'd like to see the reviewer "point out minor coding standard problems" but still approve based on the API/security/ingenuity/originality part of the review.

dave reid’s picture

I agree minor coding style errors shouldn't hold up an approval, but many times the modules submitted for review are just plain unreadable. Tabs, indentation, etc. I make my best effort to see what's going on, but I cannot give any kind of good review if I can't easily scan the code.

avpaderno’s picture

What is about a module that is trying to extend the database API, but it is doing it in the wrong way (with wrong way I mean code that is not using translatable strings, or that is not using placeholders in the SQL query)?

Also, I guess that a module containing code copied from another module present in CVS (and wrongly changed, as when the functions keep the original name) should not be accepted for CVS application.

avpaderno’s picture

Status: Active » Fixed

The book page has been already changed, and it now lists the checkpoints the proposed modules must pass.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.

avpaderno’s picture

Project: Drupal.org infrastructure » Drupal.org site moderators
Issue summary: View changes
avpaderno’s picture