Tag Index

 comments (5) debugging (1) docstrings (3) documentation (10) dry (2) errors (3) examples (1) file-level (3) getting-started (1) hardcoding (1) imports (1) installation (1) last-pass (6) logs (1) meta (1) motivation (1) naming (4) optimization (1) parameters (5) plots (2) process (5) published-code-critique (11) readme (5) refactoring (4) 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

 debugging (1)

How verbose is that log?

 docstrings (3)

In praise of writing documentation
Script docstrings
Describing parameters in docstrings

 documentation (10)

Revamping documentation
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

 examples (1)

Examining demo code samples

 file-level (3)

Directory READMEs
Organizing files for code
Script docstrings

 getting-started (1)

Documentation and mega-tools

 hardcoding (1)

Config files vs. hardcoding

 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

 logs (1)

How verbose is that log?

 meta (1)

One year later

 motivation (1)

The joy of tidying code

 naming (4)

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

 optimization (1)

Optimization vs. readability

 parameters (5)

Config files vs. hardcoding
Parameters implying other parameters
Documenting options
Using keyword arguments
Describing parameters in docstrings

 plots (2)

Config files vs. hardcoding
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 (11)

Examining demo code samples
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 (4)

The joy of tidying code
Revamping documentation
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