Hmm, leí esta pregunta un poco diferente de Robert, quien afirma correctamente que el código comentado debería eliminarse.
Sin embargo, si está buscando una convención para marcar el código para su posterior eliminación, un viejo favorito mío es:
//b = false; //TODO: remove
Algunos //TODO:
comentarios de bandera del IDE o se les puede enseñar. Si no, generalmente es una cadena de búsqueda. Es mejor seguir cualquier convención que su tienda haya establecido porque esto se puede hacer de varias maneras. Cada código base debe hacer esto de una manera. Lo mantiene investigable.
analizar rápidamente cuál es cuál?
Sin esa marca, la forma automática de hacerlo es con el compilador. Si quitar el comentario produce un código que se compila, debe haber sido un código comentado. Escribir un complemento IDE que compruebe que no sería difícil. Pero dejará atrás el código comentado con errores.
Es por eso que es mejor marcar simplemente el código comentado como código en el momento en que lo comenta. Esto le permite trabajar de manera no destructiva mientras decide si realmente quiere que desaparezca. Como todos somos interrumpidos y somos algo olvidadizos, no se sorprenda si algunas líneas se registran mientras están en ese estado. Si lo hacen, es bueno que al menos estén claramente marcados y se puedan buscar. Las macros de teclado me han ayudado con esto en el pasado. Es difícil que te interrumpan en medio de esto si puedes hacerlo con una sola pulsación de tecla.
Puede llevar esto hasta el punto de consagrar la marca en sus pruebas de integración continua. Vaya, estoy tratando de registrarme con TODO pendientes nuevamente.
///
y/** ... */
los comentarios también son utilizados por algunos generadores de documentación, como Doxygen o jsdoc. Si los usa o herramientas similares, es posible que no pueda usar ese tipo de comentarios para comentarios descriptivos que no pretenden ser parte de la documentación.