Offray/Brea
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Documentación en un sólo repo para que sea consistente.

Browse Source
This commit is contained in:
Offray Vladimir Luna Cárdenas 2020-07-27 21:17:47 -05:00
parent e759f93afb
commit 9a71c35602
1 changed files with 1 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@ -9,44 +9,8 @@ A simple dynamic distributed web site generator for public & open data, combinin
- [Markdeep][markdeep]: for agile and structured light documentation.
- **Middleware**: [Teapot][teapot]: for defining behavior, data models and connecting front-end and backend.
This is the [documentation and issues repository][brea-fossil].
The [source code repository](http://smalltalkhub.com/#!/~Offray/Brea) is hosted in SmalltalkHub.
This is the source code repository. For more information visit the [documentation and issues repository][brea-fossil].
To start run this code from [Pharo](http://pharo.org/) 6.1:
```
Metacello new
smalltalkhubUser: 'Offray' project: 'Brea';
configuration: 'Brea';
load.
```
For further instructions and documentation the recommended way to proceed is by downloading, reading and executing
the [Brea Grafoscopio interactive notebook](./doc/tip/brea.ston)
(you will need to have [Grafoscopio][grafoscopio:en] installed and to know how to use it).
![The Grafoscopio interactive notebook documenting Brea.](https://i.imgur.com/Cq8ygi9.png)
The name came out as part of a friends joke, talking about how [brea][w:brea] ([pitch][w:pitch])
allows the easy creation and preservation of fossils. This is the current incarnation of an
old project prototyped with the excellent [web2py][web2py], but this time with the advantages
of Pharo ecosystem, particularly [live coding][w:live-coding].
## Why two source code repositories?
We split the repositories in two because the Fossil powered one is well suited for files and tickets,
while the SmalltalkHub one is best suited for Smalltalk source code.
For historical reasons, different Smalltalk communities developed and hosted their source code there,
which gives them the autonomy of a simple and self-contained DVCS, that was wrote in the language they knew.
That was before the popularity of DVCS advanced by Git and GitHub, and now most projects are being migrated to
GitHub to get more visibility and improve collaboration (SmalltalkHub uses an simple optimistic versioning
system that is showing its age), while sacrificing autonomy, simplicity and self-containment.
We think that Fossil as a back end could provide the advantages of a modern DVCS, while keeping
the properties we like to have regarding autonomy, simplicity and self-containment.
At some point we hope that the work is being done in the Git/GitHub front to migrate
source code from Smalltalk would be useful to host a single Fossil repository containing
software and documentation (and issues for both).
Meanwhile, we will split them in the ones mentioned before.
[brea-fossil]: http://mutabit.com/repos.fossil/brea/home
[fossil]: http://fossil-scm.org/