La manière Softanza

La pensée et le code, côte à côte

La première diapositive de 2022 sur l'expressivité place à gauche les étapes de pensée d'un programmeur et, à droite, les mêmes étapes en code, comme si le texte de gauche avait été copié-collé et que l'on demandait à Softanza de l'exécuter. Cette diapositive est toute la discipline sur une page. Cette page est cette diapositive, rendue exécutable.

Chaque étape a une règle d'écriture ou deux qui la servent, et chaque règle sert une étape. Une ligne qui suit les règles est une étape du modèle rendue visible ; une ligne qui les enfreint cache une étape.

Sept étapes, chacune écrite

1. Définir le problème en termes naturels et en tirer les mots-clés. règles 14, 12Uppercasing and then spacifying 'softanza', so we get 'S O F T A N Z A'
2. Choisir l'objet dont parle le problème. règles 1o1 = new stzList([ "A", "", "B", "", "", "C" ])
3. Demander s'il contient. règles 9, 2? o1.ContainsEmptyStrings() #--> 1
4. Demander combien. règles 9, 3? o1.CountEmptyStrings() #--> 3
5. Demander où. règles 7, 10? o1.FindEmptyStrings() #--> [ 2, 4, 5 ]
6. Agir sur les positions, ou appeler le verbe dont le nom dit l'acte. règles 6, 4, 8, 5o1.ReplaceEmptyStrings(:With = "~")
7. Célébrer et recommencer : la réponse se lit sous sa flèche, et la chaîne garde son historique. règles 3Qh(12500).AddQ(500). ... History()

Les règles sont numérotées comme sur la page qui les énonce. Voici les étapes exécutées sur un petit problème : retirer d'une liste les éléments vides.

Étape 1, définir le problème en termes naturels : ici la définition est déjà le programme.

# 1 · say the problem in natural terms: the sentence runs
? @@( Naturally("Create a list with [ 3, 1, 3 ] and remove its duplicates").Result() )

[ 3, 1 ]

exécuté le 2026-10-08 21:47 dans la bibliothèque au commit 4a184e6f0 ; tiré de base/test/natural/multilingual_pack_narrated.ring(s'ouvre dans un nouvel onglet)

Les étapes 2 à 6 sur un seul objet : le choisir, demander si, combien et où, puis agir avec le verbe dont le nom dit l'acte.

# 2 · select the object
o1 = new stzList([ "A", "", "B", "", "", "C" ])

# 3 · does it contain?
? o1.ContainsEmptyStrings()

# 4 · how many?
? o1.CountEmptyStrings()

# 5 · where?
? @@( o1.FindEmptyStrings() )

# 6 · act on the positions, with the dedicated verb
o1.ReplaceEmptyStrings(:With = "~")
? @@( o1.Content() )

1
3
[ 2, 4, 5 ]
[ "A", "~", "B", "~", "~", "C" ]

exécuté le 2026-10-08 21:47 dans la bibliothèque au commit 4a184e6f0 ; tiré de base/doc/narrations/stz-mental-mode-narration.md(s'ouvre dans un nouvel onglet)

Étape 7, célébrer et recommencer : un pas par ligne, le point en fin de ligne, et la chaîne se souvient de chaque valeur tenue, la première comprise.

# 7 · and again: the chain keeps the history of its steps
? @@( Qh(12500).
	AddQ(500).
	RetrieveQ(1500).
	DivideByQ(500).
	MultiplyByQ(2).
	History() )

[ 12500, 13000, 11500, 23, 46 ]

exécuté le 2026-10-08 21:47 dans la bibliothèque au commit 4a184e6f0 ; tiré de base/test/string/468_pr.ring(s'ouvre dans un nouvel onglet)

La manière Softanza Chaque étape est une question posée à un objet, et chaque réponse se lit sous sa flèche. Un débutant peut suivre les sept étapes dans l'ordre, un expert peut sauter au verbe qui fait tout, et un agent est tenu à la même forme.

Trois élargissements

Les sept étapes sont le cœur. La bibliothèque les élargit dans trois directions, chacune racontée sur sa page.

Où l'on juge

Une discipline que rien ne juge est un conseil. Les juges qui existent, et celui qui n'existe pas, sont ceux-ci.

• L'apprenant. Le cours enseigne d'abord la pensée, les familles Formuler et Exprimer, et une échelle de cinq niveaux se gagne par des projets qu'un garde vérifie. Voir le livre et l'éducation.
• La réponse écrite. La forme de test de la bibliothèque, un appel avec sa réponse sous une flèche, est lue comme une promesse et comparée à ce qui s'est vraiment affiché.
• Le code de la bibliothèque. Quatorze règles de maison courent sur un graphe du code et jugent la façon dont la bibliothèque nomme ses propres méthodes.
• Les formes du vocabulaire. La grammaire des formes de fonction est déclarée comme donnée dans la charte de Haro, qui est en construction, et elle juge les noms que la bibliothèque livre.
• Un programme écrit avec la bibliothèque. Aucun juge pour l'instant (conçu). Les quatorze règles comme vérifications sur un extrait, appliquées à chaque exemple de ce site et à chaque ligne qu'un agent propose avant qu'elle soit montrée, sont spécifiées et pas construites.

Les agents lisent la manière d'abord

Les fichiers faits pour les agents portent la discipline comme donnée, avant la liste des méthodes, pour qu'un agent lise la manière avant les noms, comme l'apprenant le fait au premier chapitre : llms.txt et agents/index.json. Les deux sont générés depuis le même fichier que cette page et la page du métier, de sorte qu'un changement atteint toutes les surfaces.

Chaque encadré de ce site intitulé La manière Softanza renvoie ici.

en construction Les étapes et les règles sont lues dans les articles de la bibliothèque, ses tests et les diapositives de 2022, et sont énoncées ici comme des règles. Ce que rien ne juge encore, c'est le code qu'une personne ou un agent écrit. Aucun visiteur et aucun agent n'a encore vu cette page, de sorte que l'affirmation qu'un agent en apprend la manière, sans apprendre un dialecte réduit, attend une session mesurée.

Sources : l'article le modèle mental Softanza, dont ce sont les sept étapes ; l'article les fonctions comme expressions de la langue, d'où est tirée la plupart des règles.