Μια σελίδα προϊόντος υπόσχεται. Η τεκμηρίωση περιγράφει. Όποιος διαβάζει ένα εγχειρίδιο, μια αναφορά API ή ένα changelog, δεν διαβάζει τι λέει ένας ανταγωνιστής ότι μπορεί να κάνει, αλλά τι πρέπει πραγματικά να κάνει ένας χρήστης για να λειτουργήσει το προϊόν. Αυτή η διαφορά καθιστά την τεκμηρίωση μία από τις λίγες πηγές που λένε κάτι για τη σύγκριση σε μια διάσταση, όχι για την αντιληπτή ωριμότητα μιας εταιρείας.
Ο λόγος που αυτό είναι σχετικό τώρα δεν είναι ότι η τεκμηρίωση έχει αλλάξει. Είναι ότι οι διαστάσεις στις οποίες οι ανταγωνιστές νικούν ο ένας τον άλλον, αλλάζουν τη στιγμή που η AI αναλαμβάνει ένα μέρος της υποκείμενης εργασίας. Ο χρόνος παράδοσης ήταν επί μακρόν ζήτημα στελέχωσης προσωπικού: περισσότεροι άνθρωποι στον προγραμματισμό, μικρότερος χρόνος διεκπεραίωσης. Αν μια διαδικασία προγραμματισμού εκτελείται σε μεγάλο βαθμό από ένα μοντέλο και ένας άνθρωπος αξιολογεί πλέον μόνο τις εξαιρέσεις, ο χρόνος παράδοσης δεν είναι πια ζήτημα στελέχωσης αλλά ζήτημα μοντέλου. Όποιος δεν το έχει αντιληφθεί αυτό, συγκρίνει ακόμα τους ανταγωνιστές στην παλιά κλίμακα ενώ η νικήτρια διάσταση έχει μετατοπιστεί.
Τρία είδη ενδείξεων επανέρχονται σε τεκμηρίωση που αξίζει να διαβαστεί:
Αυτές οι ενδείξεις δεν είναι απόδειξη ενός marketing ισχυρισμού. Είναι απόδειξη μιας απόφασης προϊόντος, κάτι που τις καθιστά πιο πολύτιμες από ένα δελτίο τύπου για το ίδιο θέμα.
Η τεκμηρίωση συχνά καθυστερεί σε σχέση με το προϊόν. Μια λειτουργία που έχει γίνει καθοδηγούμενη από AI μπορεί να περιγράφεται ακόμα με τα παλιά, χειροκίνητα βήματα επειδή κανείς δεν έχει ενημερώσει το κείμενο. Συμβαίνει και το αντίθετο: τεκμηρίωση που μιλά για «έξυπνη» ή «αυτόματη» επεξεργασία ενώ η υποκείμενη λογική είναι ένα σταθερό σύνολο κανόνων χωρίς κανένα στοιχείο μάθησης. Η λέξη «αυτόματο» στην τεκμηρίωση δεν σημαίνει AI· σημαίνει μόνο ότι δεν κάνει πλέον κλικ κανένας άνθρωπος.
Μια άλλη παγίδα είναι η σύγχυση κλίμακας με παρουσία. Ένα API που προσφέρει μια λειτουργία ταξινόμησης δεν λέει τίποτα για το πόσο από τον συνολικό όγκο περνά πράγματι από αυτή τη διαδρομή έναντι του πόσο περνά ακόμα μέσω χειροκίνητης διαχείρισης εξαιρέσεων. Αυτό εξαρτάται από την υιοθέτηση εντός της πελατειακής βάσης του ανταγωνιστή, από το μέγεθος του συνόλου δεδομένων στο οποίο έχει εκπαιδευτεί το μοντέλο, και από το πόσο καιρό είναι ήδη διαθέσιμη η λειτουργία. Χωρίς αυτό το πλαίσιο, μια παράμετρος που βρέθηκε είναι μια ένδειξη, όχι ποσοστό.
Η τεκμηρίωση αλλάζει αργά. Για τα περισσότερα προϊόντα, ένας έλεγχος κάθε τρίμηνο αρκεί για να εντοπίσει διαρθρωτικές μετατοπίσεις· η εβδομαδιαία ανάγνωση σπάνια αποδίδει νέες πληροφορίες επειδή οι εκδόσεις τεκμηρίωσης δεν γίνονται καθημερινά. Σε έναν ανταγωνιστή που μόλις ανακοινώνει μια μεγάλη έκδοση, ένας άμεσος έλεγχος είναι πιο χρήσιμος από την αναμονή του σταθερού κύκλου, επειδή ακριβώς γύρω από τις εκδόσεις εξαφανίζονται χειροκίνητα βήματα ή επεκτείνονται τα API.
Η τεκμηρίωση δίνει ένα τεχνικό επίπεδο, αλλά δεν λέει τίποτα για το πώς βιώνουν οι πελάτες αυτή τη λειτουργικότητα, τι γνωρίζουν γι' αυτό οι δικοί σας πωλητές, ή πώς αντιδρά η αγορά σε αυτό κατά την αγορά. Το ίδιο μοτίβο μιας AI που εν μέρει αναλαμβάνει εργασία, εν μέρει την αφήνει υπό εποπτεία και εν μέρει την αφήνει σε ανθρώπους, είναι ορατό σε άλλα σημεία: στις απαιτήσεις και βαθμολογίες διαγωνισμών και δημόσιων προμηθειών, σε τι λένε οι αξιολογήσεις πελατών για την ταχύτητα και τη συνέπεια της παράδοσης, και σε τι ακούνε εδώ και καιρό οι δικοί σας πωλητές στο τηλέφωνο για τους ανταγωνιστές. Όποιος πρέπει να καθορίσει, μετά από μια εξαγορά, ποιος από τους δύο οργανισμούς προηγείται σε ποια διάσταση, βρίσκει μια παρόμοια προσέγγιση στο πώς τοποθετείτε σε μία γραμμή τη θέση δύο συγχωνευμένων μερών.
Το υποκείμενο ερώτημα δεν είναι τι δημοσιεύει ένας ανταγωνιστής, αλλά ποια εργασία στην ίδια σας την επιχείρηση μπορεί πράγματι να αναληφθεί από AI· αυτό απαντάται ανά εργασία με τη σάρωση εργασιών της FTE TO AI.
Ονομάστε τις δύο ή τρεις διαστάσεις στις οποίες πιστεύετε ότι νικάτε τον ανταγωνιστή του οποίου μόλις διαβάσατε την τεκμηρίωση. Χρόνος παράδοσης, ακρίβεια, χρόνος απόκρισης σε αλλαγές: ό,τι κι αν αναφέρετε, ελέγξτε αν αυτός ο ισχυρισμός βρίσκεται ακόμα στην παλιά κλίμακα ή στη νέα. Ο δωρεάν έλεγχος διαστάσεων δείχνει ποιοι από αυτούς τους ισχυρισμούς μπορούν να υποστηριχθούν με αποδείξεις και ποιοι βασίζονται σε υπόθεση. Το πλήρες benchmark, με μήτρα αποδείξεων ανά διάσταση, βρίσκεται υπό κατασκευή.