A short exercise about external communication: how to generate a text -we all are agreeing upon- using git

instructions.md 1.7KB

Is not so hard:

  • Easy way: use the gitea interface You will not yet get all what git is about, but you can make a new file, save it with the right name and .md extension, copy your part of the text, edit it and save it.

  • use GIT This means two things: first you will have git on your machine. Is a multiplatform software that works on terminal. Because terminal is easy Because terminal is the same on any machine you can enter into from remote, real or virtual. GUI’s tend to be different, terminal are the same. If you learn something on a gui you have to learn it again in a couple years. With terminal you are more or less set.

so what is GIT?

  • is a system of versioning, every time you commit to change something you record it in a… LEDGER ;)
  • so, you have this ledger on your machine, in the folder were you have the files (on unix is hidden in a invisible folder denominated .git/), and you can commit changes to it. He will keep track for you and allow to go back to a previous version, or to “fork” two or more versions, tracking changes.
  • and what if you want to work with other people?
  • that is the remote repository, a little like is on ledger.dyne.org cloud, we have a remote git server were you can pull some files and pull files, with your committs. The server will keep track of the mess and someone will be able to put it in order.
  • so what is ledger-git.dyne.org then? Is a “view” on the git server, a web GUI, with some services on top, like a wiki, a editor for files, an access… is an alternative to gitlab or to github that runs on dyne’s servers…
  • You can as well access the remote and the local git service with a local gui, like github client or any other platform specific GUI… but Terminal is going to be the same for everyone.