ajuntamentdebarcelona/free-software-guidelines-bcn-en

Free Software Management Guidelines

A series of measures and recommendations to help staff of the Municipal Institute of Information Technology (IMI), the ICT body of the Barcelona City Council, in their daily work on projects based on free software. It covers technical, social and legal aspects of free software procurement, use and production.

This document is part of the Ethical Digital Standards of the Barcelona City Council.

Metadata

Title	Free Software Management Guidelines
Version	0.2
Authors	Guillem Marpons
Reviewers	Richard Stallman, Roberto Di Cosmo, Javier Ruiz, Boris van Hoytema
Keywords	ethical digital standards, technology rights, barcelona, city council, free software, open source, floss, foss
How to cite	Guillem Marpons, 2024, Free Software Management Guidelines
Copyleft	Barcelona City Council and the authors of the text
License	Creative Commons Attribution-ShareAlike 4.0 International (CC-BY-SA-4.0)

Forking and contributing

This document can be forked, adapted, and reused under the conditions of the Creative Commons Attribution-ShareAlike 4.0 International (CC-BY-SA-4.0) license.

This repository contains the source code for the document, written in Asciidoc. The public renderized version of the document can be found at Free Software Management Guidelines. You will find instructions on how to get the renderized version of this and other related documents at https://github.com/AjuntamentdeBarcelona/ethical-digital-standards-site.

We—​the maintainers of this project and the City of Barcelona—​value your input, enjoy feedback and welcome improvements to our free software projects and documentation. For more details see the CONTRIBUTING file at the root of this repository.

free-software-guidelines-bcn-en's Issues

No 'run' instructions in README and no CONTRIBUTING guide

In order to make it easier for others to contribute to this project (also following this guide's M_4F5) I think this repository would greatly benefit from a short introduction on how to get the guide to build on your own computer, edit the files (link to introduction to ASCIIDoc) and a guide that tells you how to do a Pull Request and what happens with that.

I think the following are relevant as they also deal with 'content' more than 'code':

Example of a README from from amsterdam.github.io
Example of a CONTRIBUTING file from amsterdam.github.io