diff --git a/docs/assets/send-a-request/01-open-form.jpg b/docs/assets/send-a-request/01-open-form.jpg new file mode 100644 index 0000000..b5d8391 Binary files /dev/null and b/docs/assets/send-a-request/01-open-form.jpg differ diff --git a/docs/assets/send-a-request/02-pick-a-type.jpg b/docs/assets/send-a-request/02-pick-a-type.jpg new file mode 100644 index 0000000..0e0e636 Binary files /dev/null and b/docs/assets/send-a-request/02-pick-a-type.jpg differ diff --git a/docs/assets/send-a-request/03-report-form.jpg b/docs/assets/send-a-request/03-report-form.jpg new file mode 100644 index 0000000..278d4b5 Binary files /dev/null and b/docs/assets/send-a-request/03-report-form.jpg differ diff --git a/docs/assets/send-a-request/04-check-and-send.jpg b/docs/assets/send-a-request/04-check-and-send.jpg new file mode 100644 index 0000000..3b56cb9 Binary files /dev/null and b/docs/assets/send-a-request/04-check-and-send.jpg differ diff --git a/docs/assets/send-a-request/05-drawing-tools.jpg b/docs/assets/send-a-request/05-drawing-tools.jpg new file mode 100644 index 0000000..fd074de Binary files /dev/null and b/docs/assets/send-a-request/05-drawing-tools.jpg differ diff --git a/docs/assets/send-a-request/06-type-idea.jpg b/docs/assets/send-a-request/06-type-idea.jpg new file mode 100644 index 0000000..d469434 Binary files /dev/null and b/docs/assets/send-a-request/06-type-idea.jpg differ diff --git a/docs/assets/send-a-request/07-type-improvement.jpg b/docs/assets/send-a-request/07-type-improvement.jpg new file mode 100644 index 0000000..8740521 Binary files /dev/null and b/docs/assets/send-a-request/07-type-improvement.jpg differ diff --git a/docs/assets/send-a-request/08-type-product-sheet.jpg b/docs/assets/send-a-request/08-type-product-sheet.jpg new file mode 100644 index 0000000..89e810b Binary files /dev/null and b/docs/assets/send-a-request/08-type-product-sheet.jpg differ diff --git a/docs/assets/send-a-request/09-type-brand.jpg b/docs/assets/send-a-request/09-type-brand.jpg new file mode 100644 index 0000000..31323ee Binary files /dev/null and b/docs/assets/send-a-request/09-type-brand.jpg differ diff --git a/docs/assets/send-a-request/10-type-question.jpg b/docs/assets/send-a-request/10-type-question.jpg new file mode 100644 index 0000000..356739a Binary files /dev/null and b/docs/assets/send-a-request/10-type-question.jpg differ diff --git a/docs/assets/send-a-request/11-sending.jpg b/docs/assets/send-a-request/11-sending.jpg new file mode 100644 index 0000000..130709f Binary files /dev/null and b/docs/assets/send-a-request/11-sending.jpg differ diff --git a/docs/assets/send-a-request/12-thanks.jpg b/docs/assets/send-a-request/12-thanks.jpg new file mode 100644 index 0000000..67e929d Binary files /dev/null and b/docs/assets/send-a-request/12-thanks.jpg differ diff --git a/docs/assets/send-a-request/13-my-requests.jpg b/docs/assets/send-a-request/13-my-requests.jpg new file mode 100644 index 0000000..e7fd6a0 Binary files /dev/null and b/docs/assets/send-a-request/13-my-requests.jpg differ diff --git a/docs/tutorials/send-a-request.md b/docs/tutorials/send-a-request.md new file mode 100644 index 0000000..534db8f --- /dev/null +++ b/docs/tutorials/send-a-request.md @@ -0,0 +1,217 @@ +# How to send a request + +Tiger Studio Manager lets you send the team a problem, an idea, a catalogue fix +or a question without leaving the app. It is free, it needs **no GitHub +account**, it is sent **without your name or email**, and it becomes a **public +issue on GitHub** that the team can read and answer. + +The screens below come from Tiger Studio Manager v2.41.0. + +## Open the form + +You need to be **signed in** to Tiger Studio Manager. In the sidebar, click +**Improvements & suggestions** (1) — the ✨ button near the bottom; if the +sidebar is collapsed, it is the ✨ icon. + +The Tiger Studio Manager sidebar with the Improvements & suggestions button highlighted + +The form opens as a **side card**: the app stays usable behind it. Close it, go +to another screen, open it again — **your draft is kept** until you send it. + +## Pick a type + +There are six types, one per kind of request, and each has its own form with +its own wording. Pick the one that fits (1–6). The **Send feedback** tab (7) is +where you are; **My requests** (8) keeps track of everything you sent — see +[Follow your request](#follow-your-request). + +The six request types and the Send feedback and My requests tabs + +| Type | Use it for | Example | +|---|---|---| +| **Report a problem** | A bug, an error, something that does not work | The camera view freezes after a reconnect | +| **Suggest an idea** | A new feature for the whole Tiger System | Notify me when a spool is almost empty | +| **Suggest an improvement** | Something that exists but could be handier | Let me hide the shortcuts I never use | +| **Fix a product sheet** | A filament with a wrong or missing value in the catalogue | The barcode does not match the box | +| **Suggest a brand** | A brand that is missing from the catalogue | Example Filaments — examplefilaments.com | +| **Ask a question** | A number, a screen or a feature that puzzles you | What does the weight on a spool card include? | + +*Fix a product sheet* and *Suggest a brand* are about the **catalogue data** +(a filament's values, a missing brand). *Ask a question* is for help or an +explanation. Everything about the app itself goes in *Report a problem*, +*Suggest an idea* or *Suggest an improvement*. + +## Write your request + +The form is the same for most types: a title, a description, the pictures, the +check — then send. Here it is for **Report a problem**: + +The Report a problem form with a title and a description filled in + +1. **Problem title** — one line. +2. **Formatting toolbar** — bold, *italic*, a list, a link and emoji. +3. **Description** — what you did, what you expected, what happened instead. + +A good report, in three lines: + +> **Title:** The camera view freezes after the printer reconnects +> **Description:** 1. Open the camera view with a printer online. 2. Unplug the +> printer's network cable and plug it back. 3. The picture stays frozen until I +> restart the app. Expected: it comes back on its own. + +### The other five types + +The three app types — *Report a problem*, *Suggest an idea*, *Suggest an +improvement* — share the same layout; only the labels and the send button's name +change (**Send my report**, **Send my idea**, **Send my suggestion**). + +**Suggest an idea** — one line for the idea, then **how it would work** and +**what it would change for you**. It is for the whole Tiger System — the wilder, +the better. + +The Suggest an idea form + +**Suggest an improvement** — one line for **what to improve**, then **what is +in the way today** and **how you would like it to work**. A picture of the +screen concerned makes it clear. + +The Suggest an improvement form + +**Fix a product sheet** — search the material (brand, name, colour or barcode) +and pick it (1; 2 picks another one), then say **what is wrong** (3) and +**where you found the right value** — box, label, maker's website. + +The Fix a product sheet form with a material chosen + +**Suggest a brand** — the **name** and the **website** are required: the team +checks the site before adding the brand. The description is optional — country, +materials, where to buy. + +The Suggest a brand form + +**Ask a question** — one line for the question, then **where you saw it** and +what does not add up. Pictures help here too. + +The Ask a question form + +## Add pictures and files + +A picture shows the problem better than a description. Drag files onto the +form, **browse** for them, **paste** a screenshot, or click **Capture the +current window** (2 in the next picture). The card hides itself for a moment +so the picture shows the app, not the form — so you can close the card, go to +another screen and capture it. + +What you can attach: + +- **Up to 5 files** in total. +- **Pictures** — PNG, JPG, WEBP. +- **PDF** — up to 5 MB (a datasheet, an invoice, a label). +- **JSON** — up to 2 MB, and it must be a valid JSON file (an export, a printer + status…). +- Click the ✕ on a thumbnail to remove it. + +### Draw on a picture + +Click a picture to open the editor. Pick a tool and draw: a **box** around the +thing, **numbered steps** in the order things happen, an **arrow**… Every mark +stays editable until you click **Done** (top right); **Cancel** throws the +edits away. + +The picture editor toolbar: tools, colours, sizes, undo and redo + +1. **Move** (V) +2. **Pen** (P) +3. **Eraser** (E) +4. **Arrow** (A) +5. **Line** (L) +6. **Box** (R) +7. **Circle** (O) +8. **Highlighter** (H) +9. **Text** (T) +10. **Numbered step** (N) +11. **Blur** (B) +12. **Colours** +13. **Sizes** — S, M, L, XL +14. **Undo, redo, duplicate, delete** + +The letter shown on each tool is its keyboard shortcut. Hold the pointer over a +tool for its tip; drag an object to move it, use its corners to resize it, +**Delete** removes it. + +:::caution[Hide anything private] +The request is public. Use the **Blur** tool to cover a name, an email, an +address or an IP shown in your picture **before** you send it. +::: + +## Check and send + +The bottom of the form: attachments, automatic information, the confirmation box and the send button + +1. **Attachments** — pictures or files (optional). +2. **Capture the current window.** +3. **Automatic information** — open it to see exactly what travels with your + request. +4. **Confirmation box** — your request is **public**, so put nothing private in + it (email, address, password, IP address…). Tick the box. +5. **Send** — the button's name matches the type: **Send my report**, **Send my + idea**, **Send my suggestion**… + +What **Automatic information** contains: + +- App version, current page, operating system and window size. +- Printer **brands** — never names, addresses or codes. +- Your TigerSquad badge and XP. +- If the app recorded errors, a box lets you **attach them too**. + +## After you send + +While it sends, a short progress list runs: preparing the message, adding the +system information, sending, wrapping up. If it fails, you stay on the form +with your draft — try again. + +The sending screen with its progress list + +Then you get a confirmation: your request now exists as a public issue. Keep +the **tracking number** (1) — it is the number of the issue on GitHub. **See my +requests** (2) opens the follow-up; **Send another one** (3) starts a fresh +form. + +The Thanks for your feedback screen with the tracking number + +## Follow your request + +The **My requests** tab lists everything you sent, with its progress; the +number on the tab counts the ones still open. + +The My requests tab with requests in different statuses + +1. **Status** +2. **See it on GitHub** +3. **Close this request** +4. **Confirm** + +| Status | Meaning | +|---|---| +| **Sent** | received, nobody has looked yet | +| **In progress** | someone is working on it | +| **Done** | fixed or shipped | +| **Not planned** | the team will not do it | +| **Closed by you** | you closed it yourself | + +Only **Sent** and **In progress** requests can be closed: click the ✕, then +confirm with **Close it?**. + +**You are notified.** When a request changes status or gets a reply from the +team, a notification appears in the bell. It is checked when the app starts and +when the **My requests** tab opens. + +## If something goes wrong + +- *"It didn't go through"* — try again in a moment, your draft is still there. +- *"Sign in first"* — the request needs your Tiger account. +- *"That's a lot of reports for one day"* — a daily limit; try again tomorrow. + +--- + +**▲ [Documentation index](../../README.md)** · **Related:** [Tiger Studio](../products/tiger-studio.md), [FAQ](../faq/README.md), [Tutorials](./README.md) diff --git a/i18n/fr/tutorials/send-a-request.md b/i18n/fr/tutorials/send-a-request.md new file mode 100644 index 0000000..dc4fe4e --- /dev/null +++ b/i18n/fr/tutorials/send-a-request.md @@ -0,0 +1,240 @@ +--- +sourceHash: 69fadb6f1709482970523a7f91db7d0d293bb19eef68b0faab1fe4d63f04db93 +sourcePath: docs/tutorials/send-a-request.md +--- + +# Comment soumettre une requête + +Tiger Studio Manager vous permet d'envoyer à l'équipe un problème, une idée, une +correction du catalogue ou une question sans quitter l'application. C'est +gratuit, il ne faut **aucun compte GitHub**, la requête part **sans votre nom ni +votre e-mail**, et elle devient une **issue publique sur GitHub** que l'équipe +peut lire et à laquelle elle peut répondre. + +Les écrans ci-dessous viennent de Tiger Studio Manager v2.41.0 (en anglais ; +l'application s'affiche dans votre langue). + +## Ouvrir le formulaire + +Vous devez être **connecté** à Tiger Studio Manager. Dans la barre latérale, +cliquez sur **Améliorations & suggestions** (1) — le bouton ✨ près du bas ; si +la barre latérale est repliée, c'est l'icône ✨. + +La barre latérale de Tiger Studio Manager avec le bouton Improvements & suggestions mis en évidence + +Le formulaire s'ouvre dans une **carte latérale** : l'application reste +utilisable derrière. Fermez-la, allez sur un autre écran, rouvrez-la — **votre +brouillon est conservé** jusqu'à l'envoi. + +## Choisir un type + +Il y a six types, un par sorte de requête, et chacun a son propre formulaire +avec ses propres libellés. Choisissez celui qui convient (1–6). L'onglet +**Envoyer un retour** (7) est celui où vous êtes ; **Mes demandes** (8) garde la +trace de tout ce que vous avez envoyé — voir +[Suivre votre demande](#suivre-votre-demande). + +Les six types de requête et les onglets Send feedback et My requests + +| Type | À utiliser pour | Exemple | +|---|---|---| +| **Signaler un problème** | Un bug, une erreur, quelque chose qui ne marche pas | La vue caméra se fige après une reconnexion | +| **Proposer une idée** | Une nouvelle fonction pour tout le Tiger System | Me prévenir quand une bobine est presque vide | +| **Suggérer une amélioration** | Quelque chose qui existe mais pourrait être plus pratique | Me laisser masquer les raccourcis que je n'utilise jamais | +| **Corriger une fiche produit** | Un filament avec une valeur fausse ou manquante dans le catalogue | Le code-barres ne correspond pas à la boîte | +| **Proposer une marque** | Une marque absente du catalogue | Example Filaments — examplefilaments.com | +| **Poser une question** | Un chiffre, un écran ou une fonction qui vous laisse perplexe | Que comprend le poids affiché sur une carte bobine ? | + +*Corriger une fiche produit* et *Proposer une marque* concernent les **données du +catalogue** (les valeurs d'un filament, une marque manquante). *Poser une +question* sert à demander de l'aide ou une explication. Tout ce qui concerne +l'application elle-même va dans *Signaler un problème*, *Proposer une idée* ou +*Suggérer une amélioration*. + +## Rédiger votre requête + +Le formulaire est le même pour la plupart des types : un titre, une description, +les images, la vérification — puis l'envoi. Le voici pour **Signaler un +problème** : + +Le formulaire Signaler un problème avec un titre et une description remplis + +1. **Titre du problème** — une ligne. +2. **Barre de mise en forme** — gras, *italique*, une liste, un lien et des + emoji. +3. **Description** — ce que vous avez fait, ce que vous attendiez, ce qui s'est + passé à la place. + +Un bon signalement, en trois lignes : + +> **Titre :** La vue caméra se fige après la reconnexion de l'imprimante +> **Description :** 1. Ouvrir la vue caméra avec une imprimante en ligne. +> 2. Débrancher le câble réseau de l'imprimante et le rebrancher. 3. L'image +> reste figée jusqu'au redémarrage de l'application. Attendu : elle revient +> toute seule. + +### Les cinq autres types + +Les trois types « application » — *Signaler un problème*, *Proposer une idée*, +*Suggérer une amélioration* — partagent la même mise en page ; seuls les +libellés et le nom du bouton d'envoi changent (**Envoyer mon signalement**, +**Envoyer mon idée**, **Envoyer ma suggestion**). + +**Proposer une idée** — une ligne pour l'idée, puis **comment elle +fonctionnerait** et **ce qu'elle changerait pour vous**. Elle vaut pour tout le +Tiger System — plus elle est audacieuse, mieux c'est. + +Le formulaire Proposer une idée + +**Suggérer une amélioration** — une ligne pour **ce qu'il faut améliorer**, puis +**ce qui gêne aujourd'hui** et **comment vous aimeriez que ça fonctionne**. Une +image de l'écran concerné rend les choses claires. + +Le formulaire Suggérer une amélioration + +**Corriger une fiche produit** — cherchez le matériau (marque, nom, couleur ou +code-barres) et choisissez-le (1 ; 2 en choisit un autre), puis dites **ce qui +est faux** (3) et **où vous avez trouvé la bonne valeur** — boîte, étiquette, +site du fabricant. + +Le formulaire Corriger une fiche produit avec un matériau choisi + +**Proposer une marque** — le **nom** et le **site web** sont obligatoires : +l'équipe vérifie le site avant d'ajouter la marque. La description est +facultative — pays, matériaux, où acheter. + +Le formulaire Proposer une marque + +**Poser une question** — une ligne pour la question, puis **où vous l'avez vu** +et ce qui ne colle pas. Les images aident ici aussi. + +Le formulaire Poser une question + +## Ajouter des images et des fichiers + +Une image montre le problème mieux qu'une description. Glissez des fichiers sur +le formulaire, **parcourez** vos dossiers, **collez** une capture d'écran, ou +cliquez sur **Capturer la fenêtre actuelle** (2 dans l'image suivante). La +carte se masque un instant pour que l'image montre l'application, pas le +formulaire — vous pouvez donc fermer la carte, aller sur un autre écran et le +capturer. + +Ce que vous pouvez joindre : + +- **Jusqu'à 5 fichiers** au total. +- **Images** — PNG, JPG, WEBP. +- **PDF** — jusqu'à 5 Mo (une fiche technique, une facture, une étiquette). +- **JSON** — jusqu'à 2 Mo, et ce doit être un fichier JSON valide (un export, + l'état d'une imprimante…). +- Cliquez sur le ✕ d'une vignette pour la retirer. + +### Dessiner sur une image + +Cliquez sur une image pour ouvrir l'éditeur. Choisissez un outil et dessinez : +un **cadre** autour de l'élément, des **étapes numérotées** dans l'ordre où les +choses se passent, une **flèche**… Chaque marque reste modifiable jusqu'à ce que +vous cliquiez sur **C'est bon** (en haut à droite) ; **Annuler** jette les +modifications. + +La barre d'outils de l'éditeur d'image : outils, couleurs, tailles, annuler et rétablir + +1. **Déplacer** (V) +2. **Crayon** (P) +3. **Gomme** (E) +4. **Flèche** (A) +5. **Ligne** (L) +6. **Cadre** (R) +7. **Rond** (O) +8. **Surligneur** (H) +9. **Texte** (T) +10. **Étape numérotée** (N) +11. **Flouter** (B) +12. **Couleurs** +13. **Tailles** — S, M, L, XL +14. **Annuler, rétablir, dupliquer, supprimer** + +La lettre affichée sur chaque outil est son raccourci clavier. Maintenez le +pointeur sur un outil pour son infobulle ; faites glisser un objet pour le +déplacer, utilisez ses coins pour le redimensionner, **Suppr** le retire. + +:::caution[Masquez tout ce qui est privé] +La requête est publique. Utilisez l'outil **Flouter** pour couvrir un nom, un +e-mail, une adresse ou une IP visibles sur votre image **avant** de l'envoyer. +::: + +## Vérifier et envoyer + +Le bas du formulaire : pièces jointes, informations automatiques, case de confirmation et bouton d'envoi + +1. **Pièces jointes** — images ou fichiers (facultatif). +2. **Capturer la fenêtre actuelle.** +3. **Informations automatiques** — ouvrez-les pour voir exactement ce qui part + avec votre requête. +4. **Case de confirmation** — votre requête est **publique**, n'y mettez donc + rien de privé (e-mail, adresse, mot de passe, adresse IP…). Cochez la case. +5. **Envoyer** — le nom du bouton correspond au type : **Envoyer mon + signalement**, **Envoyer mon idée**, **Envoyer ma suggestion**… + +Ce que contiennent les **Informations automatiques** : + +- Version de l'application, page courante, système d'exploitation et taille de + la fenêtre. +- **Marques** des imprimantes — jamais les noms, adresses ou codes. +- Votre badge TigerSquad et vos XP. +- Si l'application a enregistré des erreurs, une case permet de **les joindre + aussi**. + +## Après l'envoi + +Pendant l'envoi, une courte liste de progression défile : préparation du +message, ajout des informations système, envoi, finalisation. Si ça échoue, vous +restez sur le formulaire avec votre brouillon — réessayez. + +L'écran d'envoi avec sa liste de progression + +Vous obtenez ensuite une confirmation : votre requête existe maintenant comme +issue publique. Gardez le **numéro de suivi** (1) — c'est le numéro de l'issue +sur GitHub. **Voir mes demandes** (2) ouvre le suivi ; **Envoyer un autre +retour** (3) démarre un formulaire vierge. + +L'écran de remerciement avec le numéro de suivi + +## Suivre votre demande + +L'onglet **Mes demandes** liste tout ce que vous avez envoyé, avec son +avancement ; le nombre affiché sur l'onglet compte celles qui sont encore +ouvertes. + +L'onglet Mes demandes avec des demandes à différents statuts + +1. **Statut** +2. **La voir sur GitHub** +3. **Fermer cette demande** +4. **Confirmer** + +| Statut | Signification | +|---|---| +| **Envoyée** | reçue, personne n'a encore regardé | +| **En cours** | quelqu'un travaille dessus | +| **Livrée** | corrigée ou livrée | +| **Sans suite** | l'équipe ne le fera pas | +| **Fermée par toi** | vous l'avez fermée vous-même | + +Seules les demandes **Envoyée** et **En cours** peuvent être fermées : cliquez +sur le ✕, puis confirmez avec **La fermer ?**. + +**Vous êtes prévenu.** Quand une demande change de statut ou reçoit une réponse +de l'équipe, une notification apparaît dans la cloche. Elle est vérifiée au +démarrage de l'application et à l'ouverture de l'onglet **Mes demandes**. + +## Si quelque chose ne va pas + +- *« Ça n'est pas passé »* — réessayez dans un instant, votre brouillon est + toujours là. +- *« Connecte-toi d'abord »* — la requête a besoin de votre compte Tiger. +- *« Ça fait beaucoup de signalements pour une journée »* — une limite + quotidienne ; réessayez demain. + +--- + +**▲ [Index de la documentation](../../README.md)** · **Voir aussi :** [Tiger Studio](../products/tiger-studio.md), [FAQ](../faq/README.md), [Tutoriels](./README.md) diff --git a/src/sidebar.mjs b/src/sidebar.mjs index 104d700..04cbe64 100644 --- a/src/sidebar.mjs +++ b/src/sidebar.mjs @@ -74,17 +74,18 @@ export const sidebar = [ group('Guides & tutorials', 'Guides et tutoriels', [ { slug: 'tutorials' }, + { slug: 'guides' }, { slug: 'tutorials/first-smart-spool' }, + { slug: 'tutorials/send-a-request' }, + { slug: 'guides/twin-tag-pair' }, + { slug: 'tutorials/tigerscale-serial-port-driver', label: 'TigerScale: fixing a missing COM port', translations: { fr: 'TigerScale : faire apparaître le port COM' } }, + { slug: 'guides/connect-an-ai-assistant' }, + { slug: 'guides/filament-materials-guide' }, { slug: 'tutorials/bambu-lab-a1-series', label: 'Bambu Lab A1 series: LAN mode', translations: { fr: 'Bambu Lab série A1 : mode LAN' } }, { slug: 'tutorials/bambu-lab-p1-series', label: 'Bambu Lab P1 series: LAN mode', translations: { fr: 'Bambu Lab série P1 : mode LAN' } }, { slug: 'tutorials/bambu-lab-x1-h2-p2-series', label: 'Bambu Lab X1/X1E/H2/P2: LAN mode', translations: { fr: 'Bambu Lab X1/X1E/H2/P2 : mode LAN' } }, { slug: 'tutorials/elegoo-cc2-lan-mode', label: 'Elegoo CC2: LAN mode', translations: { fr: 'Elegoo CC2 : mode LAN' } }, { slug: 'tutorials/flashforge-connection-tutorial', label: 'FlashForge: connection tutorial', translations: { fr: 'FlashForge : tutoriel de connexion' } }, - { slug: 'tutorials/tigerscale-serial-port-driver', label: 'TigerScale: fixing a missing COM port', translations: { fr: 'TigerScale : faire apparaître le port COM' } }, - { slug: 'guides' }, - { slug: 'guides/twin-tag-pair' }, - { slug: 'guides/connect-an-ai-assistant' }, - { slug: 'guides/filament-materials-guide' }, ]), group('Philosophy & vision', 'Philosophie et vision', [