From 9ae7a4bccedb656b1756ad15cfccbbf8966cd23c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Offray=20Vladimir=20Luna=20C=C3=A1rdenas?= Date: Mon, 27 Jul 2020 21:15:44 -0500 Subject: [PATCH] =?UTF-8?q?Documentaci=C3=B3n=20en=20un=20s=C3=B3lo=20siti?= =?UTF-8?q?o=20para=20que=20sea=20consistente.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 38 +------------------------------------- 1 file changed, 1 insertion(+), 37 deletions(-) diff --git a/README.md b/README.md index ba3d787..03eddbb 100644 --- a/README.md +++ b/README.md @@ -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/