Problem/Motivation

When a d.o user has created a new project (in this case, a sandbox project) the instructions for what to do next are no longer correct, now that Drupal 8 is the preferred release of Drupal:

* Create a 7.x-1.x branch.
* Write "name = ..." to a .info file.

The out-of-date information can be seen in the screenshot below.

At the very least, this could be confusing or a barrier to best practices; at worst, this could discourage potential new contributors.

Proposed resolution

Identify the component responsible for this boilerplate text and patch it with alternative text.

Consider retaining some information on how to start a Drupal 7 project (i.e. referencing a .info file rather than a .info.yml file.)

Remaining tasks

tbc.

User interface changes

None: documentation only.

API changes

None.

Data model changes

None.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

jp.stacey created an issue. See original summary.

jp.stacey’s picture

Issue summary: View changes
drumm’s picture

Project: Drupal.org customizations » Project Git instructions
Version: 7.x-3.x-dev » 7.x-1.x-dev
drumm’s picture

Drupal.org currently has these string overridden with variable_set, which I wouldn’t mind getting rid of. The code in this module looks like it is updated for the 8.x branch name, but not the info file format.

jp.stacey’s picture

@drumm thanks for forwarding this on to the right project (yours!)

It looks from the source like the branch issue has been fixed in the two "Empty*repository" functions:

But the old .info file is still referenced, not .info.yml; and the details piped into it wouldn't be sufficient for a working project (name, description, type, core.) Would cat - > @project_fullname.info.yml be a better way to handle so many values?

jp.stacey’s picture

(Ah, sorry, snap.)

drumm’s picture

I wouldn’t send people who are on average newer to terminals straight to cat - >. Maybe switch to a one-line README.txt?

jp.stacey’s picture

Status: Active » Needs review
FileSize
1.3 KB

@drumm that would be fine - anything to get them moving so they can refresh the page and go on to the next step, I guess?

With that in mind, patch attached for comment.

  • drumm committed 1cb76d1 on 7.x-1.x authored by jp.stacey
    Issue #2835029 by jp.stacey: Instructions for how to start uploading to...
  • drumm committed 87db0d4 on 7.x-1.x
    Issue #2835029: Minor formatting changes
    
drumm’s picture

Status: Needs review » Fixed
Issue tags: +needs drupal.org deployment

Looks good, deploying shortly.

drumm’s picture

Issue tags: -needs drupal.org deployment

This has been deployed to Drupal.org.

Status: Fixed » Closed (fixed)

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