GitLab Documentation

Newlines styleguide

This style guide recommends best practices for newlines in Ruby code.

# bad
def method
  issue = Issue.new

  issue.save

  render json: issue 
end
# good
def method
  issue = Issue.new
  issue.save

  render json: issue 
end

Rule: separate code and block with newlines

Newline before block

# bad
def method
  issue = Issue.new
  if issue.save
    render json: issue
  end
end
# good
def method
  issue = Issue.new

  if issue.save
    render json: issue
  end
end

Newline after block

# bad
def method
  if issue.save
    issue.send_email
  end
  render json: issue
end
# good
def method
  if issue.save
    issue.send_email
  end

  render json: issue
end

Exception: no need for newline when code block starts or ends right inside another code block

# bad
def method

  if issue

    if issue.valid?
      issue.save
    end

  end

end
# good
def method
  if issue
    if issue.valid?
      issue.save
    end
  end
end

Leave a comment below if you have any feedback on the documentation. For support and other inquires, see getting help.