📖 docs(index): documentation racine avant la 1.0#31
Merged
Conversation
Exigence du plan §4 et §10, dernier point manquant de la checklist de release. Le README installe et démarre ; ce document explique pourquoi le code fait ce qu'il fait. Il documente surtout ce qu'on a appris des fichiers réels et qui n'est écrit nulle part ailleurs : - la structure observée d'un NEF (la chaîne principale n'a qu'un IFD, tout est dans les SubIFDs), d'un CR2 (le capteur en JPEG lossless marqué Compression = 6) et d'un CR3 (PRVW sous son propre UUID à la racine, précédé de 8 octets propriétaires non documentés) ; - le piège de getimagesizefromstring(), qui accepte un JPEG lossless parce qu'elle ne lit que l'en-tête ; - la distinction corrompu / sans preview, et pourquoi l'inverser fait rejeter des fichiers lisibles. Les limites sont explicites : pas de décodage, pas de redimensionnement, et les fichiers qui n'ont objectivement aucune preview.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Dernier point manquant de la checklist de release : le plan §4 et §10 liste
docs/index.mdcomme obligatoire, au même titre que le README et la LICENSE.Ce qu'il contient
Le README installe et démarre. Ce document explique pourquoi le code fait ce qu'il fait, et documente ce qu'on a appris des fichiers réels — qui n'est écrit nulle part ailleurs :
SubIFDs, dont 24 Mo de capteur qu'un parser naïf prendrait pour une preview ;Compression = 6, honnêtement — mais aucun décodeur ne le lit ;PRVWsous son propre UUID à la racine, précédé de 8 octets propriétaires non documentés ;getimagesizefromstring(), qui accepte un JPEG lossless parce qu'elle ne lit que l'en-tête ;Les limites, explicitement
Pas de décodage (c'est la raison d'être du package), pas de redimensionnement (c'est le travail de GD), et les fichiers qui ne contiennent objectivement aucune preview.
Prochaine étape : tag
1.0.0.