Tag Index

 comments (5) docstrings (3) documentation (9) dry (2) errors (3) file-level (3) getting-started (1) imports (1) installation (1) last-pass (6) meta (1) naming (4) optimization (1) parameters (4) plots (1) process (5) published-code-critique (10) readme (5) refactoring (2) science-meaning (2) software (1) style (4) testing (3)

 comments (5)

Simplicity does not excuse bad comments
Double-check your comments
Explain your science
Crediting sources in your code
Repetitive comments

 docstrings (3)

In praise of writing documentation
Script docstrings
Describing parameters in docstrings

 documentation (9)

Documentation and mega-tools
Provide context for code
Documenting options
Directory READMEs
A pretty good README
The art of toy data
Use data files
Help others help you
In praise of writing documentation

 dry (2)

Extracting the core
Don't Repeat Yourself

 errors (3)

Include sources in error messages
Parameters implying other parameters
Useful error messages

 file-level (3)

Directory READMEs
Organizing files for code
Script docstrings

 getting-started (1)

Documentation and mega-tools

 imports (1)

Including version numbers in your code

 installation (1)

Tell me how to install this

 last-pass (6)

Updating explanations of meaning
Double-check your comments
Don't Repeat Yourself
Reproduce your work
Do a final cleanup
How I document code

 meta (1)

One year later

 naming (4)

Using simple structs
Use data files
Help others help you
Using keyword arguments

 optimization (1)

Optimization vs. readability

 parameters (4)

Parameters implying other parameters
Documenting options
Using keyword arguments
Describing parameters in docstrings

 plots (1)

Magic numbers in plotting

 process (5)

Don't Repeat Yourself
Reproduce your work
Keeping a "dry lab" lab notebook
Organizing files for code
How I document code

 published-code-critique (10)

Documentation and mega-tools
Tell me how to install this
Simplicity does not excuse bad comments
Provide context for code
Double-check your comments
Format your code
A pretty good README
Use data files
Help others help you
Do a final cleanup

 readme (5)

Documentation and mega-tools
Tell me how to install this
Provide context for code
Directory READMEs
A pretty good README

 refactoring (2)

Optimization vs. readability
Extracting the core

 science-meaning (2)

Updating explanations of meaning
Explain your science

 software (1)

Including version numbers in your code

 style (4)

Things I care about too much
Format your code
Magic numbers in plotting
Don't Repeat Yourself

 testing (3)

Developing a testing script
Automated tests
The art of toy data