Skip to content

Instantly share code, notes, and snippets.

View dciangot's full-sized avatar

Diego Ciangottini dciangot

View GitHub Profile

Passwordless login to lxplus

Why?

Because it is a pain in the ass to always write your password. Unfortunately the CERN docs is slightly mis-leading so here to go. This guide should work on any Linux distribution as long as you're not running a fossil.

Requiremments

I has been a long time since I use Windows, so probably the following does not work / is not that easy for those users. For UNIX users this should be quite straightforward. We need:

@zsup
zsup / ddd.md
Last active June 14, 2024 09:58
Documentation-Driven Development (DDD)

Documentation-Driven Development

The philosophy behind Documentation-Driven Development is a simple: from the perspective of a user, if a feature is not documented, then it doesn't exist, and if a feature is documented incorrectly, then it's broken.

  • Document the feature first. Figure out how you're going to describe the feature to users; if it's not documented, it doesn't exist. Documentation is the best way to define a feature in a user's eyes.
  • Whenever possible, documentation should be reviewed by users (community or Spark Elite) before any development begins.
  • Once documentation has been written, development should commence, and test-driven development is preferred.
  • Unit tests should be written that test the features as described by the documentation. If the functionality ever comes out of alignment with the documentation, tests should fail.
  • When a feature is being modified, it should be modified documentation-first.
  • When documentation is modified, so should be the tests.