[Oberon] Portable Project Oberon on GitHub

[Michael Schierl]

Hello Wojtek,


Am 07.12.2020 um 22:03 schrieb Skulski, Wojciech:
> Hello:
>
>    a while ago I put the Oberon System sources under the name Portable Oberon System.
> There are two "branches" on that website. One is BlackBox format. It really should have been the native Text format, but I did the cleanup under BlackBox.
> The other "branch" contains ASCII versions of the same files. Honestly these should not be used. Meaningful cleanup requires better formatting tools than plain ASCII.


GitHub thinks there are three:

master
   Default branch
   Updated 10 months ago by WojtekSkulski

Source-files-in-BlackBox-format
   Updated 10 months ago by WojtekSkulski

Source-files-in-ASCII-format
   Updated 10 months ago by WojtekSkulski

The master branch contains only a README, and the two other branches
contain the "other" files.


> Unfortunately, I have no idea how to make these files visible to the world.

On https://github.com/WojtekSkulski/Portable_Oberon_System/branches
click "change default branch" and switch it over to
"Source-files-in-BlackBox-format".

People who are interested in other branches will find those in the
Branches dropdown, but the only branch that is prominently presented on
the landing page is the default branch.

Optionally delete the "master" branch then.

> I looked at "pull requests", "actions", "packages", and all the other crap which Github is pouring on my head,

"Pull Requests" are used to communicate changes that you made to a
project that you do not own. So e.g. if I fixed a bug in your code, I
could make a pull request that you could review and integrate. Sometimes
they are also used in projects with multiple developers for one
developer to request review of his changes by another one. So far I have
not found any good reason why to create a pull request on a GitHub
repository that you own and where you are the only contributor.

"Actions" is what others would call continuous integration / continuous
testing. There you can add (Unix shell) scripts that are run
automatically whenever someone commits code, or whenever somebody
creates a pull request. Those scripts could for example try to build the
project and create an error if there is a compile time error caused by
the change. Or the scripts could automatically convert files of exotic
binary file types into HTML (if such converters exist) or even plain
text, so that they can be more easily viewed/reviewed on the Web.

"Packages" are some newfangled stuff that Oberon purists probably would
not want to use. Basically, they are a way to publish things to certain
ecosystems (NPM for JavaScript modules, Maven for Java modules, etc.) so
that they can be added as a library from some integrated development
tools or editors. (So I just say I want to use "junit:junit" and Maven
will take care to download the latest library for me and add it to my
project). Packages are nothing invented by GitHub, they just provide
convenience functions for popular package managers so you don't have to
deal with them individually.


> and I have not found an answer to a simple question "how to make the files public". Can someone more knowledgeable than I go there and just release this stuff so anybody can see it? Alternatively, please tell me how I can do it.

I could try sending a pull request to pull everything in your branch
into the master branch. But I guess it is harder for you to accept this
(and still you would then have 2 identical branches) than just cleaning
up your branches :-)

> I just read how to make a release, followed the procedure, and the only file which was released was the readme.

You probably based the release off the master branch, which only
contains the readme.



Regards,


Michael