lzigmann

Introduction

Je mets parfois, même souvent, des documents PDFs à disposition des personnes que je côtoie. Le but étant de permettre un accès facile à de la documentation ou des informations utiles au commun.

Le choix du format PDF n'est pas annodin : ce format est fait pour permettre une représentation de l'information stable et identiques entre les plateformes, qu'elle soit physique (impression) ou numérique (ordinateur, téléphone, Nintendo DS(i) …). Cela ne signifie pas que la mise en page et l'imposition seront parfaitement adaptées à ces plateformes, mais seulement qu'elle sera fidèlement retranscrite.

Seulement, ces documents peuvent contenir des erreurs — et même, de sûr, en contiendront — elles peuvent être des erreurs d'orthographe, de grammaire, de contenu ou de mise en page. Peuvent aussi se glisser (rarement) des malfonctions de portabilité, le PDF et le T_eX/L^aT_eX n'étant pas exempts de tout péchés.

Si vous rencontrez une erreur

Le pdfs devrait contenir les informations préférées pour me contacter concernant le document, la majeure partie du temps il s'agira de mon adresse mél. Si tel n'est pas le cas, veuillez voir la page d'introduction de ce site.

Avant de me contacter, soyez au point sur la section suivante.

Comment corriger ou me notifier du problème

Premièrement, si vous avez un accès à ma forge git ou à la forge d'origine du PDF, vous pouvez créer un ticket sur le dépôt correspondant. Je peux, bien évidemment, créer des accès aux personnes qui n'en ont pas.

Si vous avez accès aux sources, et/ou à l'historique git, et que vous pouvez faire la modification vous-même, envoyez moi un patch. De préférence par mél, si possible avec un Signed-off et tout autre crédit qui vous semble important (par exemple, Reported-by, Reviewed-by ou encore Suggested-by).

Si vous n'avez pas accès aux sources d'une quelconque manière, fournissez moi une description du ou des problèmes. Vous pouvez, par exemple, annoter le PDF avec okular et m'envoyer le fichier. Plus cette description est complète et claire, plus le problème sera résolue rapidement. Si le PDF que vous possédez contient un numéro de version, précisez le. Si le fichier fait plus de 1 Mo veuillez passer par envs.sh ou 0x0.st.

Ces instructions peuvent sembler superflues, mais ayant pas mal de choses à gérer, je ne peux pas nécessairement me permettre de prendre du temps à essayer de reproduire un bug, ou relire un document complet, pour corriger des erreurs. D'autant plus que ça me fait plaisir de partager et corriger mes textes, et si ça devient fastidieux ça n'est plus drôle.