https://dev.entrouvert.org/https://dev.entrouvert.org/favicon.ico?15861920342019-07-12T12:24:47ZRedmine Entr’ouvertPasserelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=1835962019-07-12T12:24:47ZFrédéric Pétersfpeters@entrouvert.com
<ul></ul><blockquote>
<p>Mettre en valeur la méthode http</p>
</blockquote>
<p>Pourquoi ?</p>
<p>Est-ce vraiment l'information la plus importante ?</p>
<p>(aussi, reléguer la description fonctionnelle, qui me semble bien plus utile, en bout à droite, pas ok)</p>
<p>(+ des détails qu'on verra plus tard)</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=1835982019-07-12T12:30:03ZBenjamin Dauvergne
<ul></ul><p>C'est mignon j'aime bien, maintenant je ne sais pas à quel point on ne devrait pas juste produire du swagger plutôt que de le refaire en CSS, swagger c'est aussi les widgets pour tester les appels, c'est quand même bien pratique.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=1835992019-07-12T12:30:56ZBenjamin Dauvergne
<ul></ul><p>Frédéric Péters a écrit :</p>
<blockquote>
<p>Est-ce vraiment l'information la plus importante ?</p>
</blockquote>
<p>Je ne crois pas non plus, l'intérêt que j'y vois est plus de se rapprocher d'une présentation devenue 'standard' dans le domaine.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=1836002019-07-12T12:31:01ZFrédéric Pétersfpeters@entrouvert.com
<ul><li><strong>Lié à</strong> <i><a class="issue tracker-4 status-1 priority-3 priority-lowest" href="/issues/10854">Autre #10854</a>: expérimenter un connecteur basé sur djangorestframework</i> ajouté</li></ul> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2059302019-12-11T11:20:57ZEmmanuel Cazenaveecazenave@entrouvert.com
<ul></ul><p>Benjamin Dauvergne a écrit :</p>
<blockquote>
<p>Frédéric Péters a écrit :</p>
<blockquote>
<p>Pourquoi ?<br />Est-ce vraiment l'information la plus importante ?</p>
</blockquote>
<p>Je ne crois pas non plus</p>
</blockquote>
<p>Pourquoi, ben pour savoir quelles méthode utiliser pour appeler le endpoint ... je ne comprends pourquoi vous tenez vous passer de cette information.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2059332019-12-11T11:25:11ZFrédéric Pétersfpeters@entrouvert.com
<ul></ul><blockquote>
<p>vous passer de cette information.</p>
</blockquote>
<p>Mon commentaire concerne la mise en valeur <strong>excessive</strong> de l'information, façon "super je peux faire un GET, et en regardant tout à droite et en plissant les yeux je pourrai peut-être savoir ce que ce GET ferait".</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2059352019-12-11T11:36:28ZBenjamin Dauvergne
<ul></ul><p>Je soutiens ce ticket juste pour le coté uniformisation de la présentation qui donne une information explicite et non équivoque et les couleurs c'est sympa.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2059382019-12-11T11:42:17ZSerghei Mihai
<ul></ul><p>J'avais par erreur poussé (<a class="changeset" title="misc: beautify endpoints présentation" href="https://dev.entrouvert.org/projects/passerelle/repository/125/revisions/b8e84681fe277eb43bd972a4bcd480e0339d92a4">b8e84681fe277eb43bd972a4bcd480e0339d92a4</a>) et reverté.<br />Donc je peux reprendre en intégrant la remarque: placer la description de l'endpoint à gauche et la méthode HTTP à droite.</p>
<p>Puis aussi prendre en compte les long_description, etc.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068002019-12-16T17:24:12ZSerghei Mihai
<ul><li><strong>Fichier</strong> <a href="/attachments/39935">passerelle.png</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/39935/passerelle.png">passerelle.png</a> ajouté</li><li><strong>Fichier</strong> <a href="/attachments/39936">0001-misc-beautify-endpoints-pr-sentation-34790.patch</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/39936/0001-misc-beautify-endpoints-pr-sentation-34790.patch">0001-misc-beautify-endpoints-pr-sentation-34790.patch</a> ajouté</li><li><strong>Statut</strong> changé de <i>Nouveau</i> à <i>Solution proposée</i></li><li><strong>Patch proposed</strong> changé de <i>Non</i> à <i>Oui</i></li></ul><p>Nouvelle version intégrant les remarques.<br />Il faudrait mieux formatter les paramètres des requetes, mais déjà voir si la distinction des endpoints convient.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068402019-12-17T09:12:49ZValentin Deniaud
<ul></ul><p>J'ai poussé <a class="issue tracker-2 status-5 priority-4 priority-default closed" title="Development: mise en forme du type de paramètre attendu (Fermé)" href="https://dev.entrouvert.org/issues/38276">#38276</a> si tu veux rebase et refaire un screenshot.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068422019-12-17T09:20:35ZSerghei Mihai
<ul><li><strong>Fichier</strong> <a href="/attachments/39940">passerelle-1.png</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/39940/passerelle-1.png">passerelle-1.png</a> ajouté</li></ul><p>Voilà.<br />ThomasJ va donner son avis aussi sur l'affaire.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068442019-12-17T09:30:55ZValentin Deniaud
<ul></ul><p>Les types sont stylés en gris et en italique normalement, tu n'as pas dû recharger ton css</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068472019-12-17T09:35:47ZSerghei Mihai
<ul><li><strong>Fichier</strong> <a href="/attachments/39941">passerelle-2.png</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/39941/passerelle-2.png">passerelle-2.png</a> ajouté</li></ul><p>Effectivement, zappé de lancer <code>collectstatic</code></p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2068842019-12-17T10:51:02ZThomas Jundtjund@entrouvert.com
<ul></ul><p>En vrac.<br />Quelques améliorations graphiques possibles</p>
<ol>
<li>Aligner les marges blanches sur celles du tableau "Sécurité" affiché en dessous.</li>
<li>Ne pas mettre l'information "Query parameters" en bold qui est une information redondante (et déjà mis en exergue par le fond blanc) mais plutôt la description de l'endpoint</li>
<li>Réduire l'espace de tabulation des paramètres</li>
<li>Aligner description & long-description sur le bloc blanc qui liste les paramètres</li>
<li>Ajouter un padding d'un espace mot au bloc blanc des paramètres</li>
<li>augmenter légèrement le margin entre les blocs endpoints</li>
<li>Caler le bloc .method-name "vraiment" en haut à gauche : sur la bordure du bloc</li>
<li>Uniformiser l'utilisation des doubles points pour les paramètres</li>
<li>Peut-être réduire l'impact visuel des blocs blanc parameters en ajoutant une opacité réduite.</li>
</ol>
<p>Code CSS</p>
<ol>
<li>Préférer em à px pour la gestion des espaces, basé sur le blanc typographique d'un espace mot (.33em ou .66em pour le double)</li>
<li>Retirer les tags des selecteurs</li>
<li>Préférer HSL pour les couleurs à la place de HEX permettrait de gagner en maintenance et mettre à jour plus simplement les couleurs</li>
<li>Vérifier si tout s'affiche bien en mobile : superposition methode / description; checker les line-height si affichage des textes en plusieurs lignes</li>
</ol>
<p>:)</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2082712020-01-06T10:05:47ZSerghei Mihai
<ul><li><strong>Fichier</strong> <a href="/attachments/40225">0001-misc-beautify-endpoints-pr-sentation-34790.patch</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/40225/0001-misc-beautify-endpoints-pr-sentation-34790.patch">0001-misc-beautify-endpoints-pr-sentation-34790.patch</a> ajouté</li><li><strong>Fichier</strong> <a href="/attachments/40227">passerelle-2020.png</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/40227/passerelle-2020.png">passerelle-2020.png</a> ajouté</li><li><strong>Fichier</strong> <a href="/attachments/40226">passerelle-2020-mobile.png</a> <a class="icon-only icon-download" title="Télécharger" href="/attachments/download/40226/passerelle-2020-mobile.png">passerelle-2020-mobile.png</a> ajouté</li></ul><p>Ok.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2083212020-01-06T13:16:36ZBenjamin Dauvergne
<ul></ul><p>Je verrais bien le nom de la méthode mis en exergue et pas au même niveau que l'URL, via le même principe que la méthode HTTP, avec un encadré collé au coin gauche de la box (Récupérer / Liste / Remplacer), quand on arrive sur la page c'est l'information la plus importante.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2083472020-01-06T14:19:17ZBenjamin Dauvergne
<ul></ul><p>Benjamin Dauvergne a écrit :</p>
<blockquote>
<p>Je verrais bien le nom de la méthode mis en exergue et pas au même niveau que l'URL, via le même principe que la méthode HTTP, avec un encadré collé au coin gauche de la box (Récupérer / Liste / Remplacer), quand on arrive sur la page c'est l'information la plus importante.</p>
</blockquote>
<p>Remarque de mon camarade Manu, pour une première version c'est très bien, oublie; Thomas J. repassera dessus et fera ça à sa sauce.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2098722020-01-15T10:36:19ZEmmanuel Cazenaveecazenave@entrouvert.com
<ul><li><strong>Statut</strong> changé de <i>Solution proposée</i> à <i>Solution validée</i></li></ul><p>Alors gogo.</p> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2098792020-01-15T10:42:48ZSerghei Mihai
<ul><li><strong>Statut</strong> changé de <i>Solution validée</i> à <i>Résolu (à déployer)</i></li><li><strong>Assigné à</strong> mis à <i>Serghei Mihai</i></li></ul><pre>
commit 010fabec811fafa7d3a93d3c7a965071a7967cdd (origin/master, origin/HEAD)
Author: Serghei Mihai <smihai@entrouvert.com>
Date: Thu Jul 11 17:08:51 2019 +0200
misc: beautify endpoints présentation (#34790)
</pre> Passerelle - Development #34790: améliorer la présentation des endpointshttps://dev.entrouvert.org/issues/34790?journal_id=2099112020-01-15T11:15:52ZFrédéric Pétersfpeters@entrouvert.com
<ul><li><strong>Statut</strong> changé de <i>Résolu (à déployer)</i> à <i>Solution déployée</i></li></ul>