8

my professor expects a full copyright documentation as well as pre post return and other conditions on top of every function in our entire project and she gave us a week to do it. Note that this is in rails. Please help me.

Comments
  • 1
    Rails is fine.
    Excessive commentation is not.
  • 1
    Use a documentation generator?
  • 1
    @RememberMe not allowed. Has to fit this format exactly. For every file and function.
  • 1
    @Root I have nothing against rails. Just trying to point out that the codebase isn't small.
  • 1
    @Techno-Wizard make a documentation generator? Some simple parsing, just read the function signature.

    You could have it stop at every function and throw up a dialog box that'll allow you to enter descriptions of all parsed args and stuff.
  • 0
    @RememberMe if I wasn't under such a time crunch I would have, but I didn't have time to put together something like that with the 2 days I had left once I finally got to the code.
  • 2
    Why do professors never have any goddamn real-world experience? They teach shit. Metaphorical useless shit that only hurts students' abilities to do something fucking useful after surviving college.

    If someone committed code like this, I would yell at them. There is absolutely zero reason to describe the bloody obvious in excruciating detail.

    Akahdjdkagajdlf.
  • 0
    That's just useless clutter that is considered bad style
  • 0
    @SoulSkrix basically. The pre and post condition is so pointless unless there's a nonobvious exception
Add Comment