SPI bylaws overhaul: new discussion draft

Luca Filipozzi lfilipoz at emyr.net
Wed Nov 16 02:27:00 UTC 2016


On Sun, Nov 13, 2016 at 11:36:52AM -0500, Hilmar Lapp wrote:
> One thing I’d submit for consideration that could be learned from this and
> change is to take the opportunity to put the text into Markdown (or LaTeX)
> format and host it in version control. Then the version control system does
> the diff, and presenting them, for you without any additional effort. 
> 
> Here’s an example from the most recent bylaws changes for OBF:
> https://github.com/OBF/obf-docs/pull/28
> https://github.com/OBF/obf-docs/pull/29
> 
> I understand that many in SPI have strong reservations about Github, but
> obviously Github is far from the only platform that allows doing this.

I think that the salient points, here, are:
- use a plain text 'source' format for the input
- use a source code management system to capture revisions and produce deltas
- publish the deltas so that the members can easily review the proposed changes
- use a formatter to 'compile' the input into published representation

We can achieve the above wthout having to use github.

I'm perfectly happy to use Markdown and I'd prefer it to LaTeX.

-- 
Luca Filipozzi
http://www.crowdrise.com/SupportDebian


More information about the Spi-general mailing list