shawnbot/swagger-template

What about stylesheets?

Offen

#1 geöffnet am 03.02.2015

Auf GitHub ansehen
 (0 Kommentare) (0 Reaktionen) (0 zugewiesene Personen) (0 Forks)github user discovery
help wanted

Repository-Metriken

Stars
 (2 Sterne)
PR-Merge-Metriken
 (Keine gemergten PRs in 30 T)

Beschreibung

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 %}

Contributor Guide

Research-Richtung
Bewerten Sie die drei Optionen zum Verteilen von Stylesheets: Bündeln, CDN Hosting oder Ignorieren und den Benutzern das Angeben in benutzerdefinierten Vorlagen überlassen. Berücksichtigen Sie Benutzerfreundlichkeit, Wartung und Flexibilität.
Tech Stack
htmlcss
Domain
frontend
Issue Type
Funktion
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
1
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
Unter 1 Stunde
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Frisch
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Klar
Voraussetzungen
Keine
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
90