You are not logged in. Your edit will be placed in a queue until it is peer reviewed.
We welcome edits that make the post easier to understand and more valuable for readers. Because community members review edits, please try to make the post substantially better than how you found it, for example, by fixing grammar or adding additional resources and hyperlinks.
-
1Are you committing the commented code to version control?Stop harming Monica– Stop harming Monica2018-08-20 21:33:47 +00:00Commented Aug 20, 2018 at 21:33
-
4If the commented code is not visible in the master branch after you merge back (and you can do that) who will be hurt?. If you feel the need to commit before getting rid of the commented-out code that hints that you might be taking too big steps, but that is a different matter.Stop harming Monica– Stop harming Monica2018-08-20 22:20:36 +00:00Commented Aug 20, 2018 at 22:20
-
6It is true that if you cmoment code, you can easily undone it by uncomment it, however if you have change ssome stuff in quite some files and need to go back, you're quite screwed without version control. So "start using source control" should be way above your priority than "not commenting code" :)Walfrat– Walfrat2018-08-21 14:45:16 +00:00Commented Aug 21, 2018 at 14:45
-
3Wait, you wrote you have a code base which is large enough that portions of it sometimes "need to be adapted to major architectural changes" - and you are CURRENTLY NOT USING VERSION CONTROL? WTF - seriously? You are joking, aren't you? If that is really true, you have larger problems than the question if your way of working with outcommented code is ok or not.Doc Brown– Doc Brown2018-08-21 18:14:03 +00:00Commented Aug 21, 2018 at 18:14
-
2@DocSalvager You too, like the OP, probably would benefit from a real version control system.Marnen Laibow-Koser– Marnen Laibow-Koser2019-03-25 23:45:11 +00:00Commented Mar 25, 2019 at 23:45
|
Show 8 more comments
How to Edit
- Correct minor typos or mistakes
- Clarify meaning without changing it
- Add related resources or links
- Always respect the author’s intent
- Don’t use edits to reply to the author
How to Format
-
create code fences with backticks ` or tildes ~
```
like so
``` -
add language identifier to highlight code
```python
def function(foo):
print(foo)
``` - put returns between paragraphs
- for linebreak add 2 spaces at end
- _italic_ or **bold**
- indent code by 4 spaces
- backtick escapes
`like _so_` - quote by placing > at start of line
- to make links (use https whenever possible)
<https://example.com>[example](https://example.com)<a href="https://example.com">example</a>
How to Tag
A tag is a keyword or label that categorizes your question with other, similar questions. Choose one or more (up to 5) tags that will help answerers to find and interpret your question.
- complete the sentence: my question is about...
- use tags that describe things or concepts that are essential, not incidental to your question
- favor using existing popular tags
- read the descriptions that appear below the tag
If your question is primarily about a topic for which you can't find a tag:
- combine multiple words into single-words with hyphens (e.g. design-patterns), up to a maximum of 35 characters
- creating new tags is a privilege; if you can't yet create a tag you need, then post this question without it, then ask the community to create it for you