shawnbot/swagger-template

What about stylesheets?

Ouverte

#1 ouverte le 3 févr. 2015

Voir sur GitHub
 (0 commentaire) (0 réaction) (0 personne assignée) (0 fork)github user discovery
help wanted

Métriques du dépôt

Stars
 (2 étoiles)
Métriques de merge PR
 (Aucune PR mergée en 30 j)

Description

This was originally part of shawnbot/swagger-static#1, but I'm moving it here for safe keeping.

Here are some options for distributing stylesheets:

  1. Just bundle a stylesheet with swagger-template and let people copy it as needed.

  2. Make a CDN-hosted default stylesheet and reference that in the swagger-template.

  3. Ignore styling altogether and let users specify stylesheets in a custom template, as in:

    {% extend "swagger.html" %}
{% block css %}
<link rel="stylesheet" href="path/to/custom.css">
{% endblock %}

Guide contributeur

Direction de recherche
Évaluez les trois options pour distribuer les feuilles de style : regrouper, héberger sur CDN ou ignorer et laisser les utilisateurs les spécifier dans des modèles personnalisés. Tenez compte de la facilité d'utilisation, de la maintenance et de la flexibilité.
Stack technique
htmlcss
Domaine
frontend
Type d'issue
Fonctionnalité
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
1
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
Moins d'une heure
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Récente
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Aucun
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
90