not-so-short-introduction-to-context icon indicating copy to clipboard operation
not-so-short-introduction-to-context copied to clipboard

An attempt to improve the repository

Open lrusso96 opened this issue 4 years ago • 2 comments

Hi, first of all thanks for the material. Here are some suggestions about the general structure of the project and how you could better achieve the goals described in your README file.

Open-Source and Locales

  • GitHub allows developers to modify the code, report and fix errors. I think it is the best way to keep the project active, maintain this repo and add new translations.
  • I have setup a simple repository which you could look at: what I do, is to use ConTeXt modes to achieve multi language support. I think that currently this repository lacks in modularity, since each language has a dedicated folder and even common files (e.g. the enviroment) are basically a copy and paste. Imagine you want to update the cover (not the text, that depends on the language, but just the layout); now, you should modify 3 different files because there are 3 languages; what generally happens is that some file is not updated, or there is some error in copy and paste, etc. What I suggest you is then to use a modular approach.
  • If you look at my repo, you will see that in a single command you can compile all the documents at-once. This is ideal when working with tools like GitHub, because you let GitHub to "continuously" compile the documents, at each commit: generally, these documents are produced and modified on a different branch, e.g. "beta", and once you are satisfied with them you merge with the master branch and upload a new release as an asset.
  • Final suggestion: you should add a License to your repository, there is a dropdown menu on GitHub for that. This is strongly suggested when publishing the source-code and working with Open-Source projects.

Italian Version

Also, I would be interested in starting an Italian translation of your document.

Final considerations

Let me know what you think about that. Feel free to convert this issue into a discussion thread (again, this is possible on GitHub) so that other people can easily communicate and interact.

Cheers!

lrusso96 avatar Jan 21 '21 18:01 lrusso96