[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#273323: doc-debian: please ship typesettable version of social contract and dfsg documents



On dinsdag 7 september 2021 11:26:15 CEST Gard Spreemann wrote:
> Diederik de Haas <didi.debian@cknow.org> writes:
> > I wanted to print the Debian Social Contract, which turned out to be WAY
> > more difficult then I expected and then it should be.
> > ...
> 
> Are any of these helpful? I'm happy to do more iterations – perhaps
> using LuaLaTeX and better fonts? This is so far just rushed lunch-work:
> 
> https://nonempty.org/~gspr/social.tex
> 
> https://nonempty.org/~gspr/social.pdf

I only looked at the pdf and it's a very nice start, thanks!

Couple of remarks, all in my opinion of course:
- I don't know if there is or should be different versions based on paper size 
(A4 vs US Letter).
- I like to have a header which is repeated on all pages and a footer which 
says "Page X of Y", so you know those (currently 3) pages belong together and 
know the sequence and how large it is in total.
In my LO Writer attempt, I had "Debian Social Contract" on the first page as 
header and "Debian Free Software Guidelines (DFSG)" on second, but I squeezed 
things to fit in those 2 pages. Probably not worth aiming for.
*If* there is an official location for the Social Contract, like 
https://www.debian.org/social_contract then I'd like to have that in the page 
header or footer as well.
- it's not in f.e. the web page, but I'd suggest the "Supersedes Version 1.0 
..." on a new line. This prevent the case where '1997' is on a line on it's 
own. It's all in 1 line on my printed version, but I decreased margins.
(Whether version history should be part of the document itself is a separate 
matter, so I'll leave that aside)
- the header "Debian will remain 100% free"* (f.e.) should be on its own line 
and I prefer it to be in "bold" or something like that to visually make a 
distinction between the header and the text.
- ideally an item of the Social Contract should fully on 1 page. The amount of 
white space on especially the first page is quite high and if that gets 
reduced, item 4 should fit on the first page as well. The amount of white space 
at the bottom of the pages seems rather high as well. It doesn't bug me, but 
if you want/need some extra lines to put text in, you could squeeze some from 
that. But not too much as some printers may then run into issues ;-)
It's possibly hard to realize this in a general case, but I assume doable for 
this specific document.
- the last part after "Example Licenses" is formatted differently on the 
website from the rest of the Social Contract and that seems correct.
The first paragraph gives some history. The 2nd shows a link between The Open 
Source Definition and the Social Contract. The 3rd looks like a kind of 
license? (without making it explicit; but also outside the scope of this bug)

Cheers,
  Diederik

*) when copying from the pdf the spaces around '100%' vanished, resulting in 
'remain100%free'

Attachment: signature.asc
Description: This is a digitally signed message part.


Reply to: