From a716408b8fa626f3a089ca29473ce3c04635a066 Mon Sep 17 00:00:00 2001 From: Steven Spencer Date: Mon, 15 Aug 2022 15:24:29 -0500 Subject: [PATCH] Remove deprecated procedure Git/Atom * Atom has been ceased to be supported by the developer * There is no way to leave this procedure in place w/o Atom * Removing the entire directory and files * modified the .pages file in Guides to remove Git, as this was the only procedure within that directory --- docs/guides/.pages | 1 - docs/guides/git/git_wf_git-cola_atom.it.md | 240 --------------------- docs/guides/git/git_wf_git-cola_atom.md | 240 --------------------- 3 files changed, 481 deletions(-) delete mode 100644 docs/guides/git/git_wf_git-cola_atom.it.md delete mode 100644 docs/guides/git/git_wf_git-cola_atom.md diff --git a/docs/guides/.pages b/docs/guides/.pages index 5971920ec2..c65ce4eb3b 100644 --- a/docs/guides/.pages +++ b/docs/guides/.pages @@ -17,7 +17,6 @@ nav: - Editors: editors - Email: email - File Sharing Services: file_sharing - - Git: git - Interoperability: interoperability - Mirror Management: mirror_management - Network: network diff --git a/docs/guides/git/git_wf_git-cola_atom.it.md b/docs/guides/git/git_wf_git-cola_atom.it.md deleted file mode 100644 index 72aad7881e..0000000000 --- a/docs/guides/git/git_wf_git-cola_atom.it.md +++ /dev/null @@ -1,240 +0,0 @@ ---- -title: git Utilizzo di Git Cola e Atom ---- - -# flusso di Lavoro git per la Documentazione: git, Git Cola e Atom - -Quindi, si vuole inviare della documentazione a questo repository. Beh, gli esperti di _git_ possono sempre darsi da fare e lavorare come fanno di solito, quindi inviarci le modifiche suggerite. Ma se siete più che altro dei principianti e state cercando un esempio di flusso di lavoro, questa guida può aiutarvi. - -Va notato subito che non si tratta assolutamente di un documento definitivo. Ci sono molte opzioni per il flusso di lavoro di git; potreste non trovare questa di vostro gradimento, e va bene così. Potreste trovare parti di questo flusso di lavoro che vi piacciono e altre che non vanno bene per voi. Anche questo va bene. - -Questo è un metodo, e l'autore spera che anche altri condividano i loro flussi di lavoro git, fornendo una ricchezza di opzioni per chiunque voglia contribuire alla documentazione di Rocky Linux. - -## Prerequisiti e Presupposti - -* Un desktop Rocky Linux (questa guida funziona anche su altre distro basate su RHEL e probabilmente anche su Fedora) -* Familiarità con la riga di comando -* Un account GitHub con accesso a chiave SSH - -## I Componenti - -Questo particolare flusso di lavoro utilizza i seguenti componenti: - -* Un fork personale del repository della documentazione che si trova [qui](https://github.com/rocky-linux/documentation) -* Una copia clonata locale del repository su una workstation Linux -* Git Cola: un client visuale per il branching e lo staging di git (opzionale) -* L'editor Atom (opzionale) - ---- - -!!! Note "Nota" - - Anche se Atom e Git Cola sono descritti come opzionali, per questo particolare flusso di lavoro è necessario almeno uno di essi. A questo autore piace usarli entrambi: uno per la parte GitHub (Git Cola) e uno per la parte di editing (Atom). - ---- - -## Installazione dei Repository - -Sono necessari solo un paio di repository. Il repository EPEL (Extra Packages for Enterprise Linux) e l'editor Atom. - -Per installare EPEL, eseguire: - -`sudo dnf install epel-release` - -Poi, abbiamo bisogno della chiave GPG per Atom e per il repository: - -`sudo rpm --import https://packagecloud.io/AtomEditor/atom/gpgkey` - -E poi: - -`sudo sh -c 'echo -e "[Atom]\nname=Atom Editor\nbaseurl=https://packagecloud.io/AtomEditor/atom/el/7/\$basearch\nenabled=1\ngpgcheck=0\nrepo_gpgcheck=1\ngpgkey=https://packagecloud.io/AtomEditor/atom/gpgkey" > /etc/yum.repos.d/atom.repo'` - -Quindi aggiornare il sistema: - -`sudo dnf update` - -## Installazione dei Pacchetti - -Eseguire il seguente comando per installare i pacchetti necessari con `dnf`: - -`sudo dnf install git git-cola` - -Ci saranno altri pacchetti installati come dipendenze, quindi è sufficiente rispondere "Y" per consentire l'installazione. - -Quindi, installare l'editor Atom: - -`sudo dnf install atom` - -## Creazione di un Fork del Repository della Documentazione di Rocky Linux - -Avrete bisogno di un vostro fork del repository. Questo diventerà uno dei vostri git remotes per questo flusso di lavoro. - -Si presuppone che abbiate già creato il vostro account GitHub, che abbiate accesso alla chiave SSH e che abbiate effettuato l'accesso a [Documentation](https://github.com/rocky-linux/documentation). - -Sul lato destro della pagina, fare clic su "Fork" (forchetta), come mostrato qui: - -![Fork della Docementazione](../images/gw_fork.png) - -Al termine, si dovrebbe avere un fork con un URL contenente il proprio nome utente. Se il nome utente di git fosse "alphaomega", l'URL sarebbe: - -``` -https://github.com/alphaomega/documentation -``` - -## Clonazione di una Copia Locale del Repository - -Poi abbiamo bisogno di una copia locale del repository, cosa abbastanza facile da fare. Ancora una volta, nella [Documentazion](https://github.com/rocky-linux/documentation) di Rocky Linux, cercate il pulsante verde "Code" e fate clic su di esso: - -![Documentation Code](../images/gw_greencode.png) - -Una volta aperto, fare clic su SSH e copiare l'URL: - -![Copia SSH Documentation](../images/gw_sshcopy.png) - -Sulla vostra stazione di lavoro Linux, in una finestra di terminale, digitate il seguente comando dalla riga di comando: - -`git clone` - -Quindi incollare l'URL nella riga di comando, in modo da ottenere questo risultato: - -`git clone git@github.com:rocky-linux/documentation.git` - -Al termine di questo comando, si dovrebbe avere una copia locale del repository della documentazione. Questa operazione crea una directory chiamata "documentation" nella vostra home directory: - -``` -home:~/documentation -``` - -## Impostazione di Git Cola - -Quindi, se si vuole configurare Git Cola, occorre aprire il repository "documentation" che abbiamo appena creato in locale e impostare i remotes. Questo è un passaggio facoltativo, ma a me piace farlo. - -È possibile impostare i propri remotes con git anche tramite la riga di comando, ma trovo questo metodo più semplice, perché per me voglio che il remoto Rocky Linux si chiami in modo diverso da "origin", che è il nome predefinito. - -Per me, penso al mio fork come a "origin" e alla documentazione di Rocky Linux come al repository "upstream". Si può non essere d'accordo. - -Quando si apre Git Cola per la prima volta, viene chiesto di selezionare il repository. Potreste averne diversi sul vostro computer, ma quello che state cercando è quello chiamato "documentation." Fate quindi clic su questo e apritelo. - -Una volta aperto il repository, configurare i remotes facendo clic su `File` e `Edit Remotes`. - -Per impostazione predefinita, mostra già il vostro Rocky Linux remoto come "origin". Per modificarlo, è sufficiente fare clic nel campo, fare un backspace su "origin", sostituirlo con "upstream" e fare clic su "Save" - -Poi, vogliamo creare un nuovo remotes che sia il vostro fork. Fare clic sul segno verde più (+) nell'angolo sinistro della parte inferiore dello schermo e si aprirà una nuova finestra di dialogo remota. Digitate "origin" per il nome e poi, supponendo che il nostro nome utente GitHub sia di nuovo "alphaomega", il vostro URL avrà questo aspetto: - -``` -git@github.com:alphaomega/documentation.git -``` -Salvate e il gioco è fatto. - -### Verificare che il flusso di lavoro funzioni effettivamente - -Eseguite tutto questo dalla riga di comando. Passare alla directory della documentazione: - -`cd documentation` - -Quindi digitare: - -`git pull upstream main` - -In questo modo si verificherà che tutto sia configurato e funzionante per prelevare dall'upstream di Rocky Linux. - -Se non ci sono problemi, digitate quanto segue: - -`git push origin main` - -In questo modo si verificherà l'accesso al proprio fork della documentazione di Rocky Linux. Se non si verificano errori, questo comando può essere unito in futuro con: - -`git pull upstream main && git push origin main` - -Questo comando deve essere eseguito prima di creare qualsiasi ramo o di eseguire qualsiasi lavoro, per mantenere i rami sincronizzati. - -## Una nota su Atom e Git Cola e sul perché l'autore li usa entrambi - -L'editor Atom è integrato con git e GitHub. In effetti, è possibile utilizzare Atom senza bisogno di Git Cola. Detto questo, le visualizzazioni fornite da Git Cola sono più chiare dal punto di vista dell'autore. Le funzionalità dell'editor di Atom superano di gran lunga quelle degli editor di markdown (sempre secondo l'opinione dell'autore). Se lo si desidera, si può eliminare la necessità di Git Cola e utilizzare semplicemente Atom. È sempre possibile eliminare Atom e utilizzare un altro editor di markdown. - -Uso Git Cola per impostare i remotes (come abbiamo già visto), per il branching e per il commit delle modifiche. Atom viene utilizzato solo come editor di testo e anteprima di markdown. Le operazioni di push e pull vengono eseguite dalla riga di comando. - -## Branching con Git Cola - -Si desidera sempre creare un ramo utilizzando il "main" come modello. Assicuratevi che "main" sia selezionato nell'elenco "Branches" sul lato destro di Git Cola, quindi fate clic sulla voce di menu superiore "Branch" e su "Create." Digitare un nome per il nuovo branch. - -!!! Note "Nota" - - Quando si assegnano i nomi ai branches, si consiglia di utilizzare nomi descrittivi. Questi contribuiranno ad aggiungere chiarezza quando li spingerete a monte. Per esempio, l'autore usa il prefisso "rl_" quando crea un nuovo documento e poi aggiunge un nome breve descrittivo del documento stesso. Per le modifiche, l'autore usa "edit_" come prefisso, seguito da un breve nome che indica il motivo della modifica. - -A titolo di esempio, qui sotto si può vedere l'elenco "Branches", che mostra "rl_git_workflow": - -![git-cola Branches](../images/gw_gcbranches.png) - -Quando si creano e si salvano le modifiche in Atom, si vedrà l'elenco "Unstaged Changes" nella vista git change: - -![Atom Unstaged](../images/gw_atomunstaged.png) - -Queste modifiche vengono visualizzate anche in Git Cola sotto la voce "Status" nella finestra di sinistra: - -![git-cola Unstaged](../images/gw_gitcolaunstaged.png) - -## Staging dei File con Git Cola - -Una volta terminato il nostro documento siamo pronti a creare la richiesta di pull, la prima cosa da fare è scrivere una dichiarazione di commit. Nella maggior parte dei casi è più facile scrivere tutto prima di eseguire il commit dei file, perché non appena si mettono in scena i file, le modifiche scompaiono dalla vista. - -La dichiarazione del commit deve essere il più chiara possibile. Il riepilogo del Commit deve indicare cosa si sta impegnando. Ad esempio: "Documento per Presentare un Flusso di Lavoro git" La descrizione estesa dovrebbe fornire i punti salienti del documento, ad esempio: - -* flusso di lavoro git con Git Cola e Atom -* Include immagini corrispondenti - -Una volta scritto il commit, ma prima di premere il pulsante "Commit", è necessario mettere in stage tutti i file ancora unstaged. A questo scopo, selezionare tutti i file, quindi fare clic con il pulsante destro del mouse e cliccare su "Stage Selected" Ora fate clic sul pulsante "Commit". - -Prima di uscire da Git Cola, nella sezione "Branches" sulla destra, fare clic con il tasto destro del mouse su "main" e fare clic su "Checkout." Vogliamo essere controllati da main prima di inviare i nostri file. - -## Pushing del Tuo Fork - -Ora che tutto il lavoro di creazione dei documenti è stato fatto, è necessario fare il push del ramo al proprio fork. Se avete seguito la creazione dei remotes in precedenza, avete creato il vostro fork come "origin" - -Dobbiamo entrare nella directory della documentazione nella finestra del terminale. In altre parole, nel clone del repository Rocky Documentation. Da una finestra di terminale, digitare: - -`cd documentation` - -Dovreste vedere la vostra home directory e il vostro cursore all'interno della documentazione: - -`home:~/documentation$` - -Ora dobbiamo fare il push delle nostre modifiche: - -`git push origin rl_git_workflow` - -Questo dice che stiamo facendo il push al nostro fork, il ramo che abbiamo appena creato e in cui abbiamo inserito un documento. - -Quando inseriamo questo comando, riceviamo un messaggio da git che dice che è possibile creare una Pull Request. Avrà un aspetto simile a questo: - -``` -Enumerating objects: 16, done. -Counting objects: 100% (16/16), done. -Delta compression using up to 6 threads -Compressing objects: 100% (12/12), done. -Writing objects: 100% (12/12), 122.01 KiB | 2.22 MiB/s, done. -Total 12 (delta 4), reused 0 (delta 0) -remote: Resolving deltas: 100% (4/4), completed with 4 local objects. -remote: -remote: Create a pull request for 'rl_git_workflow' on GitHub by visiting: -remote: https://github.com/alphaomega/documentation/pull/new/rl_git_workflow -remote: -To github.com:alphaomega/documentation.git - * [new branch] rl_git_workflow -> rl_git_workflow -``` - -## Aggiunta al Documento - -Se improvvisamente ci si rende conto di avere altre cose da aggiungere al documento e non si vuole ancora fare il PR, non c'è problema. - -Tornate a Git Cola, fate clic con il tasto destro del mouse sul vostro ramo (in questo caso "rl_git_workflow") e fate clic su "Checkout", quindi tornate a Atom, aprite di nuovo il documento e fate le modifiche necessarie. Qualsiasi modifica apportata al file o ai file dovrà essere nuovamente messa in stage e dovrà essere scritto un nuovo commit. - -Al termine, è necessario fare clic con il tasto destro del mouse sul ramo "main" e cliccare di nuovo su "Checkout"; inoltre, è necessario eseguire nuovamente il push delle modifiche al proprio fork. La differenza è che, poiché l'URL per fare la richiesta di pull (PR) è già stato inviato, non lo si riceverà di nuovo. È necessario utilizzare il link originale che è stato inviato in precedenza. - -## Attesa per il Merge del Vostro PR - -Un redattore deve dare un'occhiata al vostro documento. Devono accertarsi che tutto ciò che avete fatto e scritto corrisponda alle linee guida, e magari apportare qualche modifica. - -## Conclusione - -Tutti coloro che utilizzano git hanno un flusso di lavoro leggermente diverso. Questo è quello dell'autore. Se avete un flusso di lavoro preferito, postatelo! diff --git a/docs/guides/git/git_wf_git-cola_atom.md b/docs/guides/git/git_wf_git-cola_atom.md deleted file mode 100644 index 131c6224d7..0000000000 --- a/docs/guides/git/git_wf_git-cola_atom.md +++ /dev/null @@ -1,240 +0,0 @@ ---- -title: git Using Git Cola and Atom ---- - -# git Workflow for Documentation: git, Git Cola, and Atom - -So, you want to submit some documentation to this repository. Well, _git_ experts can always just get cracking and work how they usually do, then push their suggested changes to us. But if you're more of a beginner, and are looking for an example workflow, this guide can help. - -It should be noted at the outset that this is by no means a definitive. There are many git workflow options; you may not find this one to your liking, and that is fine. You might find parts of this workflow that you like and other parts that just don't work for you. That's fine too. - -This is one method, and the author is hopeful that others will share their git workflows as well, providing a wealth of options for anyone who wants to contribute to the documentation for Rocky Linux. - -## Prerequisites and Assumptions - -* A Rocky Linux desktop (This guide will work on other RHEL-based distros, and likely on Fedora, too.) -* Familiarity with the command line -* A GitHub account with SSH key access - -## The Components - -This particular workflow uses the following components: - -* A personal fork of the documentation repository found [here](https://github.com/rocky-linux/documentation) -* A local cloned copy of the repository on a Linux workstation -* Git Cola: a visual client for git branching and staging (optional) -* The Atom editor (optional) - ---- - -!!! Note - - While both Atom and Git Cola are described as optional, you'll need at least one of them for this particular workflow. This author likes to use both: one for the GitHub portion (Git Cola), and one for the editing portion (Atom). - ---- - -## Installing Repositories - -Only a couple of repositories are really required. The EPEL (Extra Packages for Enterprise Linux) and the Atom editor repository. - -To install the EPEL, run: - -`sudo dnf install epel-release` - -Next, we need the GPG key for Atom and the repository: - -`sudo rpm --import https://packagecloud.io/AtomEditor/atom/gpgkey` - -And then: - -`sudo sh -c 'echo -e "[Atom]\nname=Atom Editor\nbaseurl=https://packagecloud.io/AtomEditor/atom/el/7/\$basearch\nenabled=1\ngpgcheck=0\nrepo_gpgcheck=1\ngpgkey=https://packagecloud.io/AtomEditor/atom/gpgkey" > /etc/yum.repos.d/atom.repo'` - -Then update the system: - -`sudo dnf update` - -## Installing Packages - -Run the following command to install the packages we need with `dnf`: - -`sudo dnf install git git-cola` - -There will be a number of other packages installed as dependencies so simply answer 'Y' to allow the installation. - -Next, install the Atom editor: - -`sudo dnf install atom` - -## Forking the Rocky Linux Documentation Repository - -You will need your own fork of the repository. This will become one of your git remotes for this workflow. - -We are already assuming that you've created your GitHub account, have SSH key access, and are logged in to [Documentation](https://github.com/rocky-linux/documentation). - -On the right-hand side of the page, click on "Fork" shown here: - -![Documentation Fork](../images/gw_fork.png) - -When this completes, you should have a fork with a URL that has your username in it. If your git username was "alphaomega" then the URL would be: - -``` -https://github.com/alphaomega/documentation -``` - -## Cloning a Local copy of the Repository - -Next we need a local copy of the repository, which is easy enough to do. Again, from the Rocky Linux [Documentation](https://github.com/rocky-linux/documentation), look for the green "Code" button and click on it: - -![Documentation Code](../images/gw_greencode.png) - -Once open, click on SSH and then copy the URL: - -![Documentation Copy SSH](../images/gw_sshcopy.png) - -On your Linux workstation in a terminal window, enter the following at the command line: - -`git clone ` - -And then paste the URL into the command line so you should have this when done: - -`git clone git@github.com:rocky-linux/documentation.git` - -When this command is completed, you should now have a local copy of the documentation repository. This creates a directory called "documentation" in your home directory: - -``` -home:~/documentation -``` - -## Setting Up Git Cola - -Next, if you want to set up Git Cola, we need to open the "documentation" repository we just created locally, and we need to set up the remotes. This is an optional step, but I like to do it. - -You can set your remotes with git via the command line as well, but I find this method easier, because for me, I want the Rocky Linux remote to be called something different from "origin" which is what it will be named by default. - -For me, I think of my fork as the "origin" and the Rocky Linux documentation as the "upstream" repository. You may disagree. - -When you first open Git Cola, it asks you to select your repository. You could have several on your machine, but the one you are looking for is the one called "documentation." So click on this one and open it. - -Once you have your repository open, setup the remotes by clicking on `File` and `Edit Remotes`. - -By default, it will already show you your Rocky Linux remote as "origin". To change this, simply click in the field, backspace over the top of "origin," replace it with "upstream" and click "Save." - -Next, we actually want to create a new remote that is your fork. Click the green plus sign (+) in the left-hand corner of the bottom of the screen and a new remote dialog will open. Type "origin" for the name, and then, assuming our GitHub username is "alphaomega" again, your URL will look like this: - -``` -git@github.com:alphaomega/documentation.git -``` -Save this and you are done. - -### Testing that your Workflow will actually workflow - -Do this all from the command line. Change into your documentation directory: - -`cd documentation` - -Then type: - -`git pull upstream main` - -This will test that you have everything setup and working to pull from Rocky Linux upstream. - -If there are no problems, next type the following: - -`git push origin main` - -This will test access to your fork of the Rocky Linux documentation. If there are no errors, then this command can be strung together in the future with: - -`git pull upstream main && git push origin main` - -This command should be run before any branches are created or any work is done, to keep your branches in sync. - -## A Note about Atom and Git Cola and why the author uses both - -The Atom editor has integration with git and GitHub. In fact, you can use Atom without the need for Git Cola at all. That said, the visualizations that Git Cola provides are clearer from the author's view. The editor features in Atom far outweigh those that are specifically designed as markdown editors (again, the author's opinion). If you so choose, you can eliminate the need for Git Cola and simply use Atom if you like. You can always eliminate Atom and use a different markdown editor. - -I use Git Cola for setting up the remotes (as we have already seen), branching, and committing changes. Atom is used as a text editor and markdown preview only. Pushes and pulls are done from the command line. - -## Branching with Git Cola - -You always want to create a branch by using the "main" as the template. Make sure that "main" is selected in the "Branches" listing on the right-hand side of Git Cola, then click "Branch" top menu item and "Create." Type a name for your new branch. - -!!! Note - - When naming branches, consider using descriptive names. These will help add clarity when you push them upstream. For instance, the author uses an "rl_" prefix when creating a new document, and then appends the a descriptive short name for what the document is. For edits, the author uses "edit_" as the prefix followed by a short name about what the edit is for. - -As an example, below you can see the "Branches" listing, which shows "rl_git_workflow": - -![git-cola Branches](../images/gw_gcbranches.png) - -As you create and save your changes in Atom, you will see the "Unstaged Changes" listing in the git view change: - -![Atom Unstaged](../images/gw_atomunstaged.png) - -These changes also show up in Git Cola under the "Status" in the left-hand window: - -![git-cola Unstaged](../images/gw_gitcolaunstaged.png) - -## Staging the Files with Git Cola - -Once our document is done and we are ready to create the pull request, the first thing we need to do is to write a commit statement. In most cases typing it all up before committing the files is easier, because as soon as you stage your files, the changes will disappear from view. - -You want your commit statement to be as clear as possible. The Commit summary should say what you are committing. For example: "Document to Present a git Workflow." The extended description should give bullet points of the highlights of the document, for instance: - -* git workflow using Git Cola and Atom -* Includes corresponding images - -Once you've written the commit but before you hit the "Commit" button, you need to stage all of your unstaged files. To do this, select all of the files, then right-click and click on "Stage Selected." Now click the "Commit" button. - -Before you get out of Git Cola, in the "Branches" section on the right, right-click "main" and click "Checkout." We want to be checked out to main before we push our files. - -## Pushing To Your Fork - -Now that all of the document creation work is done, you need to push your branch to your fork. If you followed along as we created the remotes before, then you have created your fork as the "origin." - -We need to get into the documentation directory in the terminal window. In other words, into the clone of the Rocky Documentation repository. From a terminal window type: - -`cd documentation` - -You should see your home directory and your cursor inside documentation: - -`home:~/documentation$` - -Now we need to push our changes: - -`git push origin rl_git_workflow` - -This says we are pushing to our fork, the branch that we just created and put a document into. - -When we enter this command, we get back a message from git that says you can create a Pull Request. It will look something like this: - -``` -Enumerating objects: 16, done. -Counting objects: 100% (16/16), done. -Delta compression using up to 6 threads -Compressing objects: 100% (12/12), done. -Writing objects: 100% (12/12), 122.01 KiB | 2.22 MiB/s, done. -Total 12 (delta 4), reused 0 (delta 0) -remote: Resolving deltas: 100% (4/4), completed with 4 local objects. -remote: -remote: Create a pull request for 'rl_git_workflow' on GitHub by visiting: -remote: https://github.com/alphaomega/documentation/pull/new/rl_git_workflow -remote: -To github.com:alphaomega/documentation.git - * [new branch] rl_git_workflow -> rl_git_workflow -``` - -## Adding to the Document - -If you suddenly realize that you have more to add to your document, and don't want to do the PR as yet, that's no problem. - -Go back to Git Cola, right-click on your branch (in this case "rl_git_workflow") and click "Checkout" then go back to Atom, open your document again and make whatever additions you need to add. Any changes you make to the file or files, will again have to be staged, and a new commit will need to be written. - -You will need to right-click the "main" branch when done and click "Checkout" again, and you will need to push your changes to your fork again. The difference is that since the URL for doing the pull request (PR) has already been sent, you will not get this again. You need to use the original link that was sent before. - -## Waiting For Your PR to be Merged - -An editor has to give your document a once over. They need to be certain that everything you have done and written matches the guidelines, and maybe make some edits. - -## Conclusion - -Everyone who uses git has a slightly different workflow. This is the author's. If you have a favorite workflow, please post it!