protocolbuffers/protobuf

Generated PHP code with incorrect comment formating

Open

#14 563 ouverte le 31 oct. 2023

Voir sur GitHub
 (1 commentaire) (0 réactions) (0 assignés)C++ (16 128 forks)batch import
help wantedphp

Métriques du dépôt

Stars
 (71 223 stars)
Métriques de merge PR
 (Merge moyen 2j 11h) (185 PRs mergées en 30 j)

Description

Language: PHP

What did you do? Steps to reproduce the behavior:

  1. Go to https://github.com/googleapis/google-cloud-php/pull/6737/files
  2. Click on Dataform/src/V1beta1/Client/DataformClient.php
  3. Scroll down to setIamPolicy and see the code block over the method, it has missing asterisk sign in comments.

What did you expect to see All comments start with asterisk.

What did you see instead? ref

/**
     * Sets the access control policy on the specified resource. Replaces
    any existing policy.

    Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED`
    errors.
     *
     * The async variant is {@see DataformClient::setIamPolicyAsync()} .
     *

Guide contributeur

Direction de recherche
Examinez le modèle de commentaire du générateur de code PHP de protobuf pour identifier l'endroit où l'astérisque manquant est introduit.
Stack technique
php
Domaine
backendapi
Type d'issue
Bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
1
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Moins d'une heure
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
PHPcode generation concepts
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
85