Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Judas Priest Ate My ScrumMaster

Judas Priest Ate My ScrumMaster

Community Management in Free Software communities is still an emerging field and has produced a spectrum of practitioners: from master-manipulators of social media, to those more focused on metrics and data as a means to driving process. Either way, the state of the art is still largely driven by the needs of technical contributors to projects.
Good documentation is a crucial component in a software product and yet often technical writers are overlooked as important stakeholders of the process. Within the community, there are undoubtedly common problems between engineers and technical writers. Software Engineering is full of laws; can we show that these laws apply to technical writers as a means to help bridge the chasm between developers and technical writers??
In this talk Paul walks us through a selection of his favourite laws of software engineering and explores how developers measure them and if technical writers must also obey them. Or not. And what that means for the success of documentation in a Free Software project.

Paul Finlayson Adams

September 01, 2015
Tweet

More Decks by Paul Finlayson Adams

Other Decks in Programming

Transcript

  1. Conway’s Law (Organisations which design systems ... are constrained to

    produce designs which are copies of the communication structures of these organisations)
  2. Lehmann’s 2nd Law (As software evolves, its c o mp

    l e x i t y i n c r e a s e s unless work is done to maintain or reduce it)
  3. Pareto Law (For any given system, 80% of software bugs

    will be found in less than 20% of software modules)
  4. Lehman’s 5th Law (As a system evolves, all associated with

    it, developers, sales personnel and users, for example, must maintain mastery of its content and behaviour to achieve satisfactory evolution. Excessive growth diminishes that mastery)