5

Fallout from Deleted question audit 2018:

"How should I go about documenting the functions in comments?" is highly specific to the team. Some teams do not document functions in comments, preferring writing an actual documentation in a separated document, while keeping comments to explain the rationale of why a piece of software does what it does, others take the opposite approach and do not explain, others do both, others do nothing, some follow an style guide, others use a tool, others mix of all above.

If you find 3 programmers and ask them how they document functions, you will get 9 answers. There's nothing on this question that isn't universal. 4 answers recommend using a tool, others do not recommend tools but where, and none but Jerry Coffin answer explaining why, which if we remember, "great subjective questions inspire answers that explain 'why' and 'how'". The answers are way too short in average, for something which vary from team to team.

Can we unlock and delete this along with their duplicates?

8
  • For the guys that likes numbers, in 8 years, it didn't accrue more than 1k views per year, and shy less than 5 upvotes per year. It was closed about 1 year prior and wasn't ever voted for reopen.
    – Braiam
    Jan 5, 2019 at 10:05
  • 3
    They were both dead posts since they were asked. No significant edits, no new answers, nothing. Some people chatted about their preferences and it has historical significance now?
    – ayhan
    Jan 5, 2019 at 11:51
  • 2
    @ayhan I'm in nobody's head, but I'd hazard that was a bit of a preemptive lock so that a consensus is reached before meta strikes down on the mentioned post. Jan 5, 2019 at 12:16
  • 3
    @FélixGagnon-Grenier That would require a temporary lock though. Historical locks are permanent and should almost never be used: "An extremely popular question which is now considered inappropriate for the site may be locked for "Historical Significance": this alters the appearance of the question, automatically locks all answers as well, and disables flagging completely. This lock should be reserved for cases where a cherished cultural artifact would otherwise be deleted; do not use it for any other purpose."
    – ayhan
    Jan 5, 2019 at 12:29
  • @ayhan moderators can undo historical locks. Jan 5, 2019 at 12:31
  • @FélixGagnon-Grenier Sure but it doesn't make sense to put a historical lock on a post just to unlock it a few days later while a perfectly suitable another type of lock exists for that.
    – ayhan
    Jan 5, 2019 at 12:34
  • @FélixGagnon-Grenier note, that this was a side effect of this answer requesting for undeletion of another question by the author of one of the answers on this question
    – Braiam
    Jan 5, 2019 at 13:07
  • It's unlocked @Braiam
    – user3956566
    Jan 6, 2019 at 21:56

1 Answer 1

1

The question was unlocked and has since passed through the reopen vote review queue and is still closed. It has no delete votes on it.

enter image description here

1
  • As grandma's says: strike the iron while it's hot. Right now, there wouldn't be too much community willingness to dedicate attention to this specific case, the opportunity was lost.
    – Braiam
    Jul 31, 2019 at 15:29

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .