Outils pour utilisateurs

Outils du site


issue212:tutoriel2

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
issue212:tutoriel2 [2025/01/04 11:18] auntieeissue212:tutoriel2 [2025/01/04 18:21] (Version actuelle) andre_domenech
Ligne 105: Ligne 105:
 This seems to me to be a very powerful complex package with many options. I would like to have several worked examples of typical instructor tasks and examples of different types of questions (multiple choice, true / false, matching, etc). Searching through twenty pages of commands to find the few I need, while facing a production deadline for an assignment or test, is not my idea of fun. Having now written about more than twenty packages in these pages, and having examined at least twenty more, I think the documentation for complex packages is the weakest part of these packages. It is well-known that IT people are weak when it comes to documentation. I would like the package owners to think of their documentation as user manuals. Help users finish their first few projects with your package, otherwise they will not remain users for long.** This seems to me to be a very powerful complex package with many options. I would like to have several worked examples of typical instructor tasks and examples of different types of questions (multiple choice, true / false, matching, etc). Searching through twenty pages of commands to find the few I need, while facing a production deadline for an assignment or test, is not my idea of fun. Having now written about more than twenty packages in these pages, and having examined at least twenty more, I think the documentation for complex packages is the weakest part of these packages. It is well-known that IT people are weak when it comes to documentation. I would like the package owners to think of their documentation as user manuals. Help users finish their first few projects with your package, otherwise they will not remain users for long.**
  
-Les six premières pages de la documentation de 25 pages « couvrent les bases », comme le dit l’auteur. Le reste de la documentation est une liste annotée de commandes classées par ordre alphabétique. Si vous téléchargez le paquet depuis ctan.org, vous obtiendrez également un exemple de banque de questions avec un problème avec un graphique.+Les six premières pages de la documentation de 25 pages « couvrent les bases », comme le dit l’auteur. Le reste de la documentation est une liste annotée de commandes classées par ordre alphabétique. Si vous téléchargez le paquet depuis ctan.org, vous obtiendrez également un exemple de banque de questions avec un problème et un graphique.
  
 Cela me semble être un paquet complexe très puissant avec de nombreuses options. J’aimerais avoir plusieurs exemples de tâches typiques d’un instructeur et des exemples de différents types de questions (choix multiple, vrai/faux, correspondance, etc.). Chercher dans vingt pages de commandes pour trouver les quelques-unes dont j’ai besoin, tout en ayant une date limite de production pour un devoir ou un test, n’est pas l'idée que je me fais du plaisir. Ayant maintenant écrit sur plus de vingt paquets dans ces pages, et en ayant examiné au moins vingt autres, je pense que la documentation des paquets complexes est la partie la plus faible de ces paquets. Il est bien connu que les informaticiens sont faibles en matière de documentation. J’aimerais que les propriétaires de paquets considèrent leur documentation comme des manuels d’utilisation. Aidez les utilisateurs à terminer leurs premiers projets avec votre paquet, sinon ils ne resteront pas des utilisateurs très longtemps. Cela me semble être un paquet complexe très puissant avec de nombreuses options. J’aimerais avoir plusieurs exemples de tâches typiques d’un instructeur et des exemples de différents types de questions (choix multiple, vrai/faux, correspondance, etc.). Chercher dans vingt pages de commandes pour trouver les quelques-unes dont j’ai besoin, tout en ayant une date limite de production pour un devoir ou un test, n’est pas l'idée que je me fais du plaisir. Ayant maintenant écrit sur plus de vingt paquets dans ces pages, et en ayant examiné au moins vingt autres, je pense que la documentation des paquets complexes est la partie la plus faible de ces paquets. Il est bien connu que les informaticiens sont faibles en matière de documentation. J’aimerais que les propriétaires de paquets considèrent leur documentation comme des manuels d’utilisation. Aidez les utilisateurs à terminer leurs premiers projets avec votre paquet, sinon ils ne resteront pas des utilisateurs très longtemps.
Ligne 125: Ligne 125:
 Comments can be made conditional. By default, once defined, the comment environment contents are global in the document. They can be made local using the begingroup / endgroup commands. Comment commands can be made special and be defined by the user. There are some other specialized commands available in the four page documentation. This looks like it could be quite useful when preparing various versions of a document, either for various readers or in order to record various revisions and potential edits.** Comments can be made conditional. By default, once defined, the comment environment contents are global in the document. They can be made local using the begingroup / endgroup commands. Comment commands can be made special and be defined by the user. There are some other specialized commands available in the four page documentation. This looks like it could be quite useful when preparing various versions of a document, either for various readers or in order to record various revisions and potential edits.**
  
-Le prochain paquet est cette fois le paquet « comment » (commentaire), dernière révision 2016 August. L'auteur dit que le paquet permet à l'utilisateur de « sélectionner/exclure des morceaux de texte : l'utilisateur peut définir de nouvelles versions de commentaires et chacune est contrôlée séparément ». Il fonctionne en configurant un environnement de commentaire. Tout contexte dans cet environnement est ignoré lorsque le document est compilé. Voir les exemples qui utilisent et n'utilisent pas de commentaire. Notez comment le premier paragraphe est répété lorsque le code de commentaire est supprimé du fichier source.+Le prochain paquet est cette fois le paquet « comment » (commentaire), dernière révision août 2016. L'auteur dit que le paquet permet à l'utilisateur de « sélectionner/exclure des morceaux de texte : l'utilisateur peut définir de nouvelles versions de commentaires et chacune est contrôlée séparément ». Il fonctionne en configurant un environnement de commentaire. Tout contexte dans cet environnement est ignoré lorsque le document est compilé. Voir les exemples qui utilisent et n'utilisent pas de commentaire. Notez comment le premier paragraphe est répété lorsque le code de commentaire est supprimé du fichier source.
  
 \documentclass[letterpaper,12pt]{article} \documentclass[letterpaper,12pt]{article}
Ligne 176: Ligne 176:
 Le paquet ulem contient également les commandes sout, xout et dotuline : barrer, marquer chaque lettre avec une ligne oblique et souligner avec des points (voir illustration). D'autres styles de soulignement peuvent être définis par l'utilisateur. Un petit avertissement : puisque chaque mot souligné est placé dans une zone de texte, la césure automatique de ce mot est désactivée. Les six pages de documentation sont faciles à comprendre et contiennent suffisamment d'exemples pour que l'utilisateur puisse faire des essais sans problème. Le paquet ulem contient également les commandes sout, xout et dotuline : barrer, marquer chaque lettre avec une ligne oblique et souligner avec des points (voir illustration). D'autres styles de soulignement peuvent être définis par l'utilisateur. Un petit avertissement : puisque chaque mot souligné est placé dans une zone de texte, la césure automatique de ce mot est désactivée. Les six pages de documentation sont faciles à comprendre et contiennent suffisamment d'exemples pour que l'utilisateur puisse faire des essais sans problème.
  
-La prochaine fois, nous commencerons un examen du paquet babel dans l'espoir d'apprendre à l'utiliser pour écrire du texte dans différentes langues. Je ne peux écrire qu'en anglais, en français, en latin, en grec ancien et en chinois. J'espère que cela soit suffisamment de choix pour que nous puissions explorer babel ensemble.+La prochaine fois, nous commencerons un examen du paquet babel dans l'espoir d'apprendre à l'utiliser pour écrire du texte dans différentes langues. Je ne peux écrire qu'en anglais, en français, en latin, en grec ancien et en chinois. J'espère que cela sera suffisant comme choix pour que nous puissions explorer babel ensemble.
  
issue212/tutoriel2.1735985930.txt.gz · Dernière modification : 2025/01/04 11:18 de auntiee