Once more with style
Considering whether your project needs a style guide
John SJ Anderson
John is the VP of Technology for Infinity Interactive, a technology consultancy and bespoke software development shop. When he's not madly trying to keep up with the pace of change in Javascript development, maintaining Perl modules, or tweaking his Emacs config, he likes to play around with new languages like Swift and Rust and write about himself in the third person.
Would your Open Source software project benefit from a style guide? Would your project at work? It's tempting to reply to these questions with a reflexive "Yes, of course!" — the benefits of having an established coding style for a project, having rules around how things are formatted, what language features are to be used and which are to be avoided, seem obvious. It makes it easier to onboard new contributors, establishes a baseline expectation for drive-by pull requests, and makes the code review process more transparent.
But style guides aren't free. Setting one up can involve a significant amount of effort, and, depending on the number of contributors involved in the discussion, can be a significant source of stress and strife. Many projects have been highly successful with nary a hint of any sort of overall style guidance.
So what's a maintainer to do? Style guide, or no? Come to this talk to learn more about the tradeoffs between having a style guide and not having a style guide, as well as some tooling options that you may not be aware of that will make it easier to move towards having some style guidelines, without having to invest a bunch of upfront effort into something you may end up hating.
- Date:
- 2019 November 16 - 14:00
- Duration:
- 20 min
- Room:
- TALKS 3183
- Conference:
- SeaGL 2019 - A Prime Year for Free Software
- Language:
- Track:
- Documentation
- Difficulty:
- Easy
- There and Back Again, Reproducibly!
- Start Time:
- 2019 November 16 14:00
- Room:
- TALKS 3178
- 2019: A Lisp Odyssey
- Start Time:
- 2019 November 16 14:00
- Room:
- TALKS 3180
- Project Springtime: a DIY backyard hydroponics system developed open-source-style
- Start Time:
- 2019 November 16 14:00
- Room:
- TALKS 3179
- TeaGL
- Start Time:
- 2019 November 16 14:15
- Room:
- Expo Hall