Note: This section of the site is under heavy construction, tread carefully.

Bookmarks tagged with “bestpractice”

299 bookmarks by garrettc


How to create a Python package in 2022

"How do you create a Python package? How do you set up automated testing and code coverage? How do you publish the package? That's what this article teaches you."

Bookmarked on #


Reduce Friction – Ceejbot's notes

"The topic of reducing friction exhausts me: Do people still need to be persuaded to help their developers go faster? Really? In this, the year 2022? But yes, in this, the year 2022, many teams require persuasion on this topic."

Bookmarked on #


Boost Your Django DX

"During my years working with Django, I’ve picked up many tools and techniques to boost my Developer Experience, or DX. This book covers as many of these as possible, so you can learn them too!" - Adam Johnson

Bookmarked on #




Unit testing Django and Wagtail

A repository for the discussion and publication of the CFPB development team standards.

Bookmarked on #


APIs as ladders

"Developers have opinions on what a good API1 is, but rarely have a shared vocabulary to describe what makes them good. This essay puts forward one set of considerations (out of many) that we started using at Stripe in 2019 to discuss API design."

Bookmarked on #


Lessons learned from six-years leading a community of practice

"I re-launched the Ministry Of Justice’s product management community of practice in 2016. It started with 10-12 people and, six-years later, it’s approaching 80 people. The same number of people have come and gone during that time. In 2021 I picked-up leadership across the user-centred, product and delivery professions, increasing my scope to 350+ people across 6 specialisms. Now’s a good time to reflect on what I’ve learned."

Bookmarked on #


Django styleguide

Useful tips for starting a Django project.

Bookmarked on #


10 tools I wish I knew when I started working with Python

Learn about how venvs, flake8, black, isort, pytest, commitizen, semantic-release, pre-commit hooks, and Github Actions work together.

Bookmarked on #


Your CSS is an interface

“Interfaces are our gateway to working with computers.”

Bookmarked on #


The Well-Maintained Test: 12 Questions for New Dependencies

"Joel Spolsky’s infamous Joel Test is a quick heuristic test for checking a software engineering team’s technical chops. I’ve come up with a similar test that we can use to decide whether a new package we’re considering depending on is well-maintained."

Bookmarked on #



A minimal Django testing style guide

"This post is not about setting the gold standard on how to write tests for your Django application. It’s about setting a simple direction as possible. And getting started. Wherever you are."

Bookmarked on #


Django Model Behaviors

"As Django projects scale in complexity beyond the neat and tidy tutorial phase, how can we structure our models to keep things manageable?"

Bookmarked on #


From data to Viz. Find the graphic you need

"From Data to Viz provides a decision tree based on input data format. This tree leads to twenty formats representing the most common dataset types. For each, an example of analysis based on real-life data is provided using the R programming language."

Bookmarked on #


Python Best Practices for a New Project in 2021

The goal of this tutorial is to describe Python development ecosystem. It can be helpful for someone coming to Python from another programming language.

Bookmarked on #


Open working toolkit

"This toolkit gives charities and funders the best resources for learning why and how to work in the open, share work and reuse work from others."

Bookmarked on #


PAGNIs: Probably Are Gonna Need Its

“Because I like attempting to coin phrases, I propose we call these PAGNIs—short for Probably Are Gonna Need Its.”

Bookmarked on #


YAGNI exceptions

"There are some things which really are easier to do earlier than later, and where natural tendencies or a ruthless application of YAGNI might neglect them"

Bookmarked on #


The Button Cheat Sheet

Do you need a button for your next project but you’re not sure about the right markup? Don’t worry, we’ve got you covered!

Bookmarked on #


Standup Braindump

Good advice on how to run a standup.

Bookmarked on #


Django Best Practices

"This is a living document of best practices in developing and deploying with the Django Web framework. These should not be seen as the right way or the only way to work with Django, but instead best practices we’ve honed after years of working with the framework."

Bookmarked on #


UX Theatre: The Poster

"UX Theatre is easy to define. It's the application of any sort of design methodology without including a single user in the process. UX theatre is becoming more prevalent as executives learn the term user experience but their teams aren't empowered to do all the work that UX entails. "

Bookmarked on #


Let’s talk about failure

“Not #humblebrag - ‘I’m a massive success because I failed fast’ failure. But failure in service design. Because every system fails at some point.”

Bookmarked on #


Convince Your Boss to Care About Speed

"Are you trying to convince your boss to commit to web performance work without much success? We have tips."

Bookmarked on #


How to Report Errors in Forms: 10 Design Guidelines

"Help users recover from errors by clearly identifying the problems and allowing users to access and correct erroneous fields easily."

Bookmarked on #


The Best Place for Error Messages on Forms

"Where are you placing the error messages on your form? If they’re not placed where users expect to see them, you could jeopardize their capability to complete your form."

Bookmarked on #


The Ultimate UX Design of Form Validation

"Form validation is the technical process where a web-form checks if the information provided by a user is correct. The output of this process is emotional rather than technical. The form either points out that the user made an error, or assures that the provided data is accurate. "

Bookmarked on #




Diátaxis document framework

The Diátaxis framework aims to solve the problem of structure in technical documentation. It adopts a systematic approach to understanding the needs of documentation users in their cycle of interaction with a product.

Bookmarked on #


A thorough team guide to RFCs

Defining a process for decision-making

Bookmarked on #


Accessibility Strategies for Your Content Team

"Content creators can have a major impact on accessibility, here are some tips and tools to help empower content creators to take ownership of accessibility."

Bookmarked on #


How to Improve CSS Performance

Learn the most common speed issues caused by CSS and how to avoid them.

Bookmarked on #


An Accessible Current Page Navigation State

"Design and technical considerations behind the icon that indicates what page you're currently on."

Bookmarked on #


Diversity focused job boards

Good resource list from Kimberley Cook

Bookmarked on #


Web Platform Design Principles

This document contains a set of design principles to be used when designing Web Platform technologies.

Bookmarked on #


Readability Guidelines

A collaboratively developed, universal content style guide, based on usability evidence. Created by Content Design London.

Bookmarked on #







Don’t Use ARIA Menu Roles for Site Nav

"A properly-coded web page navigation menu needs no ARIA. Once you add ARIA, however, you have put yourself on the hook to handle some complex interactions."

Bookmarked on #


Microsoft: Inclusive Design

Inclusive Design is a methodology, born out of digital environments, that enables and draws on the full range of human diversity. Most importantly, this means including and learning from people with a range of perspectives.

Bookmarked on #


Geri Reid - Forms best practice

Best practice for forms, including research insights and examples.

Bookmarked on #



Channels Are Free

Advice for Slack management.

Bookmarked on #


Inclusive Design Principles

"These Inclusive Design Principles are about putting people first. It's about designing for the needs of people with permanent, temporary, situational, or changing disabilities — all of us really. They are intended to give anyone involved in the design and development of websites and applications - designers, user experience professionals, developers, product owners, idea makers, innovators, artists and thinkers - a broad approach to inclusive design."

Bookmarked on #