search

larmarange / analyse-R

Introduction à l'analyse d'enquêtes avec R et RStudio
https://larmarange.github.io/analyse-R/
56 stars 42 forks source link

Structure du site #45

Closed larmarange closed 6 years ago

larmarange commented 9 years ago

Discussion de la structure du site

En lien avec le wiki https://github.com/larmarange/analyse-R/wiki/Structure-du-texte

larmarange commented 9 years ago

Je me demande si on ne pourrait revoir la structure du site avec trois grandes entrées : Manipuler, Analyser, Approfondir

Le site serait alors divisé ainsi :

Manipuler

NB : les chapitres de la sous-section Manipulation des données présenteraient à la fois, pour chaque type de problème, R base, dplyr, data.table.

Analyser

Aprofondir

Il y aurait donc du débutant et de l'avancé dans chaque section.

On indiquerai en page d'accueil que pour ceux débutant avec R, on les invite à lire en tout premier lieu la sous-section Prise en main de Manipuler puis la sous-section Statistiques introductives de la section Analyser.

larmarange commented 9 years ago

@briatte

En un sens, cela amène une structure globale systématiquement en sections et sous-sections. Avec trois grandes entrées indiquées par des verbes ce qui fait qqch de plus dynamique.

Dans la foulée, je supprimerai bien le bouton Accueil car il fait doublon dans le menu avec analyse-R qui renvoie aussi vers l'accueil.

Je regrouperai bien les index et le PDF sous une même entrée Naviguer ou Chercher. Ou pourrait même y déplacer le chapitre Où trouver de l'aide ?.

Enfin, il y aurait assez de place pour ramener Participer dans le menu principal. Est-ce que le terme Contribuer serait plus approprié ? On pourrait rajouter une page expliquant les différentes manières de participer (forums, indiquer les bugs et les coquilles, proposer des chapitres, etc.)

briatte commented 9 years ago

Comme je viens juste de découvrir la structure actuelle, j'ai du mal à me projeter dans une autre. Celle-ci me semble plus difficile d'accès.

Dans la foulée, je supprimerai bien le bouton Accueil car il fait doublon dans le menu avec analyse-R qui renvoie aussi vers l'accueil.

OK.

Enfin, il y aurait assez de place pour ramener Participer dans le menu principal. Est-ce que le terme Contribuer serait plus approprié ? On pourrait rajouter une page expliquant les différentes manières de participer (forums, indiquer les bugs et les coquilles, proposer des chapitres, etc.)

"Contribuer" plutôt que "Participer" : :+1:

Ramener dans le menu principal : personnellement, je le trouve bien tout à droite. En revanche, le sous-menu n'est pas utile : un lien simple vers GitHub suffirait, sauf si tu veux rajouter une page "Comment aider", ce qui peut être une bonne idée.

larmarange commented 9 years ago

Je viens de regarder rapidement la table des matières de R Cookbook, R for everyone et R in action. Tout ce qui est manipulation de données (y compris avancée) est présenté avant l'analyse.

La difficulté est de concilier utilisateur débutant et utilisateur avancé. Mais il ne me semble pas problématique que l'ordre d'un cours ne soit pas forcément l'ordre d'un manuel.

Je vais laisser passer la nuit et j'essaie de préparer une réorga du site demain soir.

briatte commented 9 years ago

Je suis fan des mêmes bouquins que toi, mais comme tu dis, la difficulté est de rendre le texte utile pour tout le monde. Je serais d'avis d'organiser le texte pour des débutants, et de laisser les utilisateurs avancés se débrouiller pour trouver ce qui les intéresse — dans les sections Analyse et Extras, principalement.

larmarange commented 9 years ago

Tout ce qui est du domaine de la manipulation de données est centrale et n'a pas sa place en tant que tel dans la section Analyses. Il faut une section dédiée.

Toute la partie prise en main relève soit de la manipulation du logiciel, soit de la manipulation des données.

Pour un débutant, l'ordre "chronologique" serait de l'ordre:

Dans le cadre d'un cours, on fait la navette entre les deux. C'est justement l'idée d'une structuration en sections et sous-sections. Deux grands pôles Manipuler / Analyser et à chaque fois une progression intro / intermédiaire / avancé

larmarange commented 9 years ago

Une alternatie pourrait être une structuration en

larmarange commented 9 years ago

J'ai un peu discuté avec différents collègues ce matin pour avour un feedback un peu extérieur.

Dans ce qu'il en ressort, c'est tout d'abord que lorsqu'on arrive sur un tel site avec un besoin donné il est préférabe d'avoir une aborescence thématique qui répond à la question Qu'est ce que je veux faire ?. Dès lors une structuration de premier niveau du type Débutant / Intermédiaire / Avancé ne serait pas pertinente car on ne saurait pas a priori ce qui appartiendra à chaque niveau. L'approche Manipuler / Analyser / Approfondir s'avère ici plus pertinente.

Par contre, il faut également fournir un parcours facile à suivre pour quelqu'un qui découvre tout juste R. Cela peut se faire à la fois avec des intitulés de sous-sections explicites et avec, en page d'accueil, un parcours proposé aux personnes qui débutent avec R.

larmarange commented 9 years ago

Voilà, j'ai repris en détail la page https://github.com/larmarange/analyse-R/wiki/Structure-du-texte

Je me lance dans la restructuration des fichiers dans la soirée.

briatte commented 9 years ago

J'ai lu le wiki, ça a l'air bien !

larmarange commented 9 years ago

OK.

Je viens d'envoyer un gros lot de commits. La nouvelle structure du site est en place. J'en ai profité pour créer de nombreux chapitres vides (avec un warning). Mais comme ça la structure est en place et on peut déjà faire des liens internes lors de l'écriture.

Ce fut d'ailleurs une bonne idée car cela m'a permis de voir qu'il fallait réorganiser les menus (qui sont maintenant sur 3 colonnes). J'en ai aussi profité pour générer programmatiquement le menu de la page d'accueil.

Sur la page d'accueil, un parcours de lecture est proposé aux débutants.

J'ai aussi réorganisé les préfixes des fichiers et le rangement des figures créées par knitr en dossiers et sous-dossiers. ATTENTION : les captures d'écran doivent rester à la racine de images/ car images/manipuler, images/analyser et images/approfondir sont supprimés par le script Makefile avant d'être regénérés.

briatte commented 9 years ago

Looks good!

Le PDF est trop difficile à trouver ; je serais d'avis de pousser "Contribuer" à droite comme avant (avec une petit icône GitHub ?), et de mettre un lien direct "Télécharger (PDF)" (ou "Télécharger" avec une icône PDF ?) vers le PDF à la place.

"Naviguer" pourrait s'appeler "Index".

La ligne "Accueil … Développement … analyse-R en PDF" me paraît redondante avec les menus. N'indiquer que la licence suffirait.

Est-ce qu'il y a moyen, dans les menus déroulants, de montrer l'état d'avancement des chapitres, pour distinguer ce qui est déjà rédigé du reste ?

larmarange commented 9 years ago

Est-ce qu'il y a moyen, dans les menus déroulants, de montrer l'état d'avancement des chapitres, pour distinguer ce qui est déjà rédigé du reste ?

Tu penses à quel type de visuel ? Fond coloré uniquement ou plus ?

briatte commented 9 years ago

Un fond coloré suffirait à repérer ce qui est déjà lisible.

larmarange commented 9 years ago

Le PDF est trop difficile à trouver ; je serais d'avis de pousser "Contribuer" à droite comme avant (avec une petit icône GitHub ?), et de mettre un lien direct "Télécharger (PDF)" (ou "Télécharger" avec une icône PDF ?) vers le PDF à la place.

Une première remarque générale, le site responsive, donc il faut penser à regarder ce que ça donne quand on redimensionne la largeur. ;-)

Quitte à pousser à droite, pourquoi ne pas mettre directement un GitHub Ribbons cf. https://github.com/blog/273-github-ribbons que l'on masquerai sur petit écran ?

Il faut essayer de garder un peu de place pour pouvoir rajouter un champs de recherche.

Pour le PDF, est-ce que juste le texte PDF n'est pas suffisant ?

briatte commented 9 years ago

Ribbon : ça me va.

"PDF" suffirait, oui.

larmarange commented 9 years ago

OK

je viens de committer les modifs demandées

briatte commented 9 years ago

"Exporter des graphiques" est en double

Lequel te paraît le plus approprié ?

larmarange commented 9 years ago

A mon sens, il est préférable que ca apparisse en clair dans le menu, donc dans PEM. Il suffit de faire un renvoi dans graph univ. (au besoin on peut garder 3-4 lignes dans graph_univ, puisque la redite n'est pas un souci)

briatte commented 9 years ago

Je comprends, mais en même temps, aucune section avant "Exporter des graphiques" ne produit de graphiques, non ?

larmarange commented 9 years ago

Il suffit de déplacer au début de manipulation de données (intermédiaires) ?

Joseph

2015-07-07 22:36 GMT+02:00 François notifications@github.com:

Je comprends, mais en même temps, aucune section avant "Exporter des graphiques" ne produit de graphiques, non ?

— Reply to this email directly or view it on GitHub https://github.com/larmarange/analyse-R/issues/45#issuecomment-119328610 .

larmarange commented 9 years ago

Et dans graph univarié juste aborder le bouton exporter de RStudio, sans rentrer dans les détails sur le type d'images

briatte commented 9 years ago

Il suffit de déplacer au début de manipulation de données (intermédiaires) ?

C'est pas vraiment intermédiaire, sauf si on fait un truc complet en expliquant aussi comment paramétrer les dimensions et la résolution des graphiques.

À la rigueur, je dirais : à la toute fin de "stats. intro.", en rajoutant aussi un chapitre sur "Exporter des tableaux", ce qui serait très utile, au passage.

J'aurais également tendance à placer "Interv. de confiance" et "Comp. de moyennes/props" dans "Stats. intro.", après "Données pondérées".

larmarange commented 9 years ago

Je suis d'accord pour intervalles de confiance et comparaisons.

Pour ce qui est des exports de graphiques et de tableaux, cela relève clairement de Manipuler et pas d'Analyser. Il faut que ces informations soient accessibles dans le cadre des entrées thématiques ce qui n'empêche pas que cela puisse aussi être présenté (plus succinctement) dans les chapitres analytiques correspondants (tout comme il y a des graphiques dans stats univariées même si c'est complété ensuite dans un chapitre plus important).

Faudrait-il une sous-section supplémentaire Exporter dans Manipuler, avec Exports de données, Export de graphiques, Export de tableaux ?

Joseph

Le 7 juillet 2015 22:50, François notifications@github.com a écrit :

Il suffit de déplacer au début de manipulation de données (intermédiaires) ?

C'est pas vraiment intermédiaire, sauf si on fait un truc complet en expliquant aussi comment paramétrer les dimensions et la résolution des graphiques.

À la rigueur, je dirais : à la toute fin de "stats. intro.", en rajoutant aussi un chapitre sur "Exporter des tableaux", ce qui serait très utile, au passage.

J'aurais également tendance à placer "Interv. de confiance" et "Comp. de moyennes/props" dans "Stats. intro.", après "Données pondérées".

— Reply to this email directly or view it on GitHub https://github.com/larmarange/analyse-R/issues/45#issuecomment-119335053 .

briatte commented 9 years ago

Ce serait une bonne idée ! J'exporte tout avec xtable mais je sais que ce n'est pas la seule solution.

larmarange commented 9 years ago

Juste pour simplifier (et éviter d'avoir 4 sections dans Manipuler), que dirais-tu de :

2015-07-08 13:48 GMT+02:00 François notifications@github.com:

Ce serait une bonne idée ! J'exporte tout avec xtable mais je sais que ce n'est pas la seule solution.

— Reply to this email directly or view it on GitHub https://github.com/larmarange/analyse-R/issues/45#issuecomment-119548481 .

briatte commented 9 years ago

Ça me va !

larmarange commented 9 years ago

section exporter crée. Je te laisse faire le renommage des fichiers et le js du menu quand tu pourras

larmarange commented 9 years ago

Je viens de procéder au renommage des fichiers. Au passage, plus besoin de préciser le répertoires des graphiques (c'est auto). Et le menu fonctionne

briatte commented 9 years ago

Nickel !

larmarange commented 9 years ago

Pour info, je viens de procéder à une réorga de la partie prise en main, suite à des sessions de formation que j'ai réalisée en Afrique du Sud. Un peu moins de technique dans premier travail avec les données, mais ajout de quelques calculs et graphiques simples pour mieux voir les possibilités de R. Puis 3 chapitres qui reprennent les objets de base et l'indexation. Il me reste la partie Recodage à compléter et la section Prise en main devrait être complète.