"The duty to document does not cease in a crisis, it becomes more essential."
By Daina Bouquin, Christopher Ball, Anna-Lena Lamprecht, Catherine Jones, Tyler J. Skluzacek. Containers, virtual machines, Jupyter notebooks, web applications, and data visualisations that run in a browser are all examples of complex digital objects made up of multiple components. Each of those components may have unique dependencies (hardware, software, external datasets, etc.) and different “authors”.  Each component will also have different expected functionalities and may even have different licenses.
By Raniere Silva, Software Sustainability Institute.Documentation is, alongside version control, testing/continuous integration and others, one of the best practices for software development and is crucial for new users. In the recent years, with the professionalism of open source drive by companies such as Red Hat, Anaconda (formerly Continuum Analytics), RStudio, Overleaf, we saw not only releases come out faster but also documentation be richer.

One of these four exchanges occurs regularly in everyday life…

Tourist: “I think I'm lost, please could you tell me how to get to the National Portrait Gallery?”

Policeman: “Read the f------ map!”

Diner: “Excuse me, what are today's specials?”

Waitress: “Read the f------ menu!”

Interviewer: “And, minister, what is your policy on unemployment?”

Politician: “Read the f------ manifesto!”

Researcher: “How do convert my model into a PDF as it doesn’t seem to work?”

Developer: “Read the f------…

By Devasena Inupakutika, Software Consultant at the Software Sustainability Institute.

The problem with open source software is not that it is free but that some people think this means they have got something for nothing. As an article by MongoDB vice president Matt Asay pointed out, developers really are spoilt these days​.

Yet there is no such thing as free software. When we call software "free", it means that it respects the user's essential freedoms: the freedom to run it, to study and change it, and to redistribute copies with or without changes. The source code can…

Subscribe to Documentation