void-linux / void-linux/void-docs

config/network/firewall.md: needs some rework/clarifications.

Offen
#512 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

bug enhancement help wanted
Vorherrschende Sprache
CSS
Sterne
217
Forks
212
Ø Merge
2 T. 21 Std.
Gemergte PRs (30 T.)
1

Beschreibung

We currently have here two sections "Applying rules at boot" and "Applying rules at runtime" both are ambiguous.
Both of them work at boot and at runtime, they are two alternative methods, with the one "Applying rules at boot" being clearly the better solution because they don't need a fake service and they make sure firewall rules are loaded before network services are up.

  • Change the headlines for "Applying rules at X".
  • Make clear that they are two ways of loading rules at boot and at runtime, make clear that core-services/rc.local is superior.
  • Document how to reload rules with the fake service, sv can be used and with the better core-services or rc.local method the nftables (or iptables) command can be used.

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Öffne config/network/firewall.md und vergleiche die derzeit mit „Applying rules at boot“ und „Applying rules at runtime“ betitelten Abschnitte. Stelle klar, dass dies alternative Möglichkeiten sind, Regeln beim Booten und zur Laufzeit zu laden, erkläre, warum core-services/rc.local bevorzugt wird, und dokumentiere das Neuladen mit sv oder dem nftables/iptables-Befehl; die aktualisierten Abschnittsüberschriften und Anweisungen sollten die Mehrdeutigkeit beseitigen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Veraltet
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
48/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.