Συντακτικά πρότυπα και δοκιμές

Ποιος δημοσιεύει και ελέγχει τους οδηγούς

Το AskClean είναι προϊόν της NEXALIFY Ltd. Οι οδηγοί για τον χώρο αποθήκευσης γράφονται από την ομάδα του AskClean και ελέγχονται τεχνικά με βάση την τρέχουσα συμπεριφορά του προϊόντος, τις διεπαφές του λειτουργικού συστήματος και τις πρωτογενείς πηγές που παραθέτουν.

Η ετικέτα ελέγχου σε ένα άρθρο σημαίνει ότι η ομάδα μηχανικών επαλήθευσε τα όρια της διαγραφής, τις εντολές, τις διαδρομές και το κόστος ανάκτησης. Δεν σημαίνει ότι κάθε συσκευή θα ανακτήσει τον ίδιο χώρο.

Πώς δοκιμάζουμε τις οδηγίες για τον χώρο αποθήκευσης

Ξεκινάμε με μια απογραφή μόνο για ανάγνωση, καταγράφουμε τη σχετική έκδοση και το μέγεθος, αλλάζουμε μία κατηγορία και μετράμε ξανά. Ξεχωρίζουμε τη συμπεριφορά του προϊόντος που επαναλαμβάνεται σταθερά από τα αποτελέσματα που ισχύουν μόνο για ένα συγκεκριμένο μηχάνημα, και δεν μετατρέπουμε μία μόνο συσκευή δοκιμών σε καθολική υπόσχεση εξοικονόμησης χώρου.

Οι καταστροφικές εντολές δεν είναι η προεπιλογή. Οι οδηγοί προτιμούν τις διεπαφές του συστήματος, την αναστρέψιμη διαγραφή στον Κάδο, ρητούς ελέγχους αντιγράφων ασφαλείας και σαφή εξήγηση για το τι θα χρειαστεί να αναδημιουργηθεί ή να ληφθεί ξανά.

Το μοντέλο μας για τον κίνδυνο διαγραφής

Κάθε κατηγορία αποθήκευσης ταξινομείται πρώτα με βάση το κόστος ανάκτησης και μετά με βάση το μέγεθος. Τα αναδημιουργήσιμα παράγωγα αρχεία μπορούν να παραχθούν ξανά από τον πηγαίο κώδικα· τα αρχεία που λαμβάνονται ξανά προϋποθέτουν πρόσβαση στο δίκτυο και ότι η πηγή τους εξακολουθεί να τα διαθέτει· η κατάσταση λειτουργίας μπορεί να περιέχει τοπικές βάσεις δεδομένων, συσκευές δοκιμών ή ρυθμίσεις· τα τεκμήρια εκδόσεων και τα αρχεία που δημιούργησε ο χρήστης μπορεί να είναι αναντικατάστατα.

Κάθε οδηγός πρέπει να κατονομάζει την κατηγορία, την προεπιλεγμένη θέση της ή την εντολή με την οποία εντοπίζεται, τι αλλάζει η διαγραφή, τον τρόπο ανάκτησης και τον ασφαλέστερο έλεγχο μόνο για ανάγνωση. Η ηλικία και το μέγεθος ενός αρχείου δεν αρκούν ποτέ από μόνα τους για να χαρακτηριστεί ένα στοιχείο ασφαλές.

Αναπαραγώγιμα τεκμήρια και επαναχρησιμοποιήσιμο υλικό

Οι οδηγοί μας για τον χώρο του Xcode μοιράζονται ένα script ελέγχου που μπορείτε να κατεβάσετε και που εκτελεί μόνο εντολές μέτρησης μεγέθους φακέλων και απογραφής μέσω simctl. Το script δεν διαγράφει αρχεία, δεν ζητά δικαιώματα διαχειριστή και δεν ανεβάζει πουθενά τα αποτελέσματα. Οι αναγνώστες μπορούν να εξετάσουν τον κώδικά του πριν το εκτελέσουν και να συγκρίνουν τις ίδιες μετρήσεις πριν και μετά από μία αλλαγή.

Οι πίνακες τεκμηρίωσης στους οδηγούς μας περιγράφουν τα όρια της διαγραφής, όχι υποσχέσεις εξοικονόμησης χώρου. Μπορείτε να παραθέσετε αυτούς τους πίνακες ή τη μέθοδο ελέγχου με σύνδεσμο προς τον σχετικό οδηγό ή προς αυτή την πολιτική. Για διόρθωση, λεπτομέρειες αναπαραγωγής ή αντίγραφο ενός πίνακα σε μηχαναγνώσιμη μορφή, επικοινωνήστε με τη συντακτική ομάδα.

Πηγές και διαχωρισμός από το εμπορικό περιεχόμενο

Για τη συμπεριφορά του λειτουργικού συστήματος παραπέμπουμε στην τεκμηρίωση της Apple όπου υπάρχει πρωτογενής πηγή. Τα στιγμιότυπα οθόνης προϊόντων προέρχονται από δικές μας εκδόσεις των εφαρμογών ή από προσομοιωτές και επισημαίνονται ανάλογα.

Το AskClean και το Photo Slim μπορεί να εμφανίζονται σε έναν οδηγό ως σχετικά εργαλεία. Η παρουσία τους δεν αλλάζει τα τεχνικά όρια: αναφέρουμε σε τι έχει πρόσβαση κάθε εφαρμογή, σε τι δεν έχει και ποιες ενέργειες εξακολουθούν να απαιτούν την επιβεβαίωση του χρήστη.

Διορθώσεις

Το λογισμικό αλλάζει. Αν μια ετικέτα μενού, μια διαδρομή, μια εντολή ή μια δήλωση ασφάλειας έχει ξεπεραστεί, στείλτε την ακριβή διεύθυνση URL της σελίδας και τη διόρθωση στο [email protected]. Εξετάζουμε τις διορθώσεις που μπορούν να εφαρμοστούν στην πράξη και ενημερώνουμε την ημερομηνία τροποποίησης του άρθρου όταν αλλάζει η ουσία του.

Πρότυπο τεκμηρίωσης

Ελέγξτε τα τεκμήρια