Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #25434

Re: Diagramming code

Show all headers | View raw

Thank you Fred.

I am new to python and am reviewing code I find online.

Some projects do have docs that spell out what its doing,
but many projects that I have download have just the code.

I have my own personal style to decypher C and C++ code.

But python is still foreign to me.

hamilton


On 7/16/2012 11:02 AM, Sells, Fred wrote:
> You leave many relevant questions unanswered.
>
> 1. Is the original developer/team available or have you been left with
> the code and little or no doc's?
>
> 2. How big is big in terms of the number of files/modules in the
> project?
>
> 3. Is there a reasonable structure to the project in terms of
> directories and a meaningful hierarchy
>
> 4. Does the project currently work and you just have to maintain/enhance
> it or was it "abandoned" by the original team in an unknown state and
> you have to save a sinking ship?
>
> 5. Are you an experienced Python programmer or a beginner.
>
> 6. Is the original code "pythonic" (i.e. clean and simple with brief,
> well organized methods) or do you have functions over 50 lines of code
> with multiple nested control statements and meaningless variable names?
>
> 7. Is there any documentation that defines what it should do and how it
> should do it.  i.e. how do you know when it's working?
>
> These issues are not really Python specific, but if you've been given a
> "broken" project that has 200 poorly organized modules and little or no
> documentation and no access to the original team, a good first step
> would be to update your resume ;)
>
> OK then, let me ask, how do you guys learn/understand large projects ?
>
> hamilton
>
> --
> http://mail.python.org/mailman/listinfo/python-list
>

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Diagramming code hamilton <hamilton@nothere.com> - 2012-07-15 19:26 -0600
  Re: Diagramming code Chris Rebert <clp2@rebertia.com> - 2012-07-15 18:38 -0700
    Re: Diagramming code hamilton <hamilton@nothere.com> - 2012-07-15 19:57 -0600
      Re: Diagramming code Chris Rebert <clp2@rebertia.com> - 2012-07-15 19:13 -0700
      Re: Diagramming code Ulrich Eckhardt <ulrich.eckhardt@dominolaser.com> - 2012-07-16 09:58 +0200
        Re: Diagramming code Joel Goldstick <joel.goldstick@gmail.com> - 2012-07-16 05:00 -0400
      RE: Diagramming code "Sells, Fred" <fred.sells@adventistcare.org> - 2012-07-16 13:02 -0400
        Re: Diagramming code hamilton <hamilton@nothere.com> - 2012-07-16 12:36 -0600
      Re: Diagramming code Dennis Lee Bieber <wlfraed@ix.netcom.com> - 2012-07-16 13:51 -0400
    Re: Diagramming code 88888 Dihedral <dihedral88888@googlemail.com> - 2012-07-17 07:11 -0700
    Re: Diagramming code 88888 Dihedral <dihedral88888@googlemail.com> - 2012-07-17 07:11 -0700
  Re: Diagramming code Miki Tebeka <miki.tebeka@gmail.com> - 2012-07-16 12:47 -0700
  Re: Diagramming code Andrea Crotti <andrea.crotti.0@gmail.com> - 2012-07-16 21:41 +0100
    Re: Diagramming code Andrew Cooper <amc96@cam.ac.uk> - 2012-07-16 23:24 +0100

csiph-web