NL.16 is ambiguous
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 75/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- cpp, markdown
- Área
- documentation
Línea de trabajo
Lee la directriz NL.16 y las discusiones mencionadas en los issues #962, #977 y #980. Después, consulta la aclaración anterior en el commit edbfc3b. El issue propone añadir uno de sus dos ejemplos de código para dejar explícito el orden preferido. Se considera terminado cuando NL.16 indique claramente qué orden se prefiere.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Previously discussed in #962, #977, #980.
The recommendation according to the guideline is:
When declaring a class use the following order
- types: classes, enums, and aliases (
using)- constructors, assignments, destructor
- functions
- data
Use the
publicbeforeprotectedbeforeprivateorder.
These are two different dimensions, kind (types, special member functions, functions, data) and access (public, protected, private), without clearly stating which takes priority.
Discussion from editors on previous issues (i.e. comment which appears to reference comment) seems to indicate that access takes priority over kind:
class X {
public:
void f();
int i;
private:
void g();
int j;
};
At the same time, NL.16 was updated with the goal of clarifying, adding the text:
Sometimes, the default order of members conflicts with a desire to separate the public interface from implementation details. In such cases, private types and functions can be placed with private data.
Here, it's stated that "a desire to separate the public interface from implementation details" (i.e. grouping every kind of public member together, as in the above snippet) is in conflict with "the default order of members." This seems to indicate that this is not the default, which would mean that the default order of members is instead to prioritize kind over access:
class X {
public:
void f();
private:
void g();
public:
int i;
private:
int j;
};
So, the guideline as written does not clearly explain which dimension takes priority, and searching through the repository history shows that when this came up previously, there were two simultaneous but contradictory resolutions.
Suggestion: Provide one of the two above snippets as an unambiguous example of NL.16 showing the preferred first choice (when you have no constraints or better ideas).
- Lenguaje dominante
- CSS
- Estrellas
- 45.5k
- Forks
- 5.6k
- Merge medio
- 6 min
- PR fusionados (30 d)
- 1
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de isocpp/CppCoreGuidelines
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 78/100
isocpp/CppCoreGuidelines#2345 ·
-
Use short #s-xxx as ref, not long like #sl-the-standard-library or #gsl-guidelines-support-libraryAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
isocpp/CppCoreGuidelines#2340 ·
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
isocpp/CppCoreGuidelines#2205 · 8 comentarios ·
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 64/100
isocpp/CppCoreGuidelines#1649 · 3 comentarios ·
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
isocpp/CppCoreGuidelines#2342 · 2 comentarios ·
Todos los issues de isocpp/CppCoreGuidelines
Issues similares
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 75/100
cran-task-views/Spatial#130 ·
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster no-stale P2
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
openclaw/openclaw-windows-node#2287 · 2 comentarios · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
daniel-ospina/tortoise#13343 ·
Los mantenedores suelen responder en 1 día
-
[Docs]: Clarify theme variables location and usage in CONTRIBUTING.mdPosiblemente ocupada @srishtimishra520-beep la tomó hoy. Abiertokind/docs
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
meshery/meshery.io#3220 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Revise communication normsAbiertocurrent task
Dificultad 1/5 1-3 horas Aptitud para principiantes 88/100
Sunday-School-Software/Sunday-School-Scheduler#87 ·
Los mantenedores suelen responder en 1 día