October 2016 - Pharo-users - lists.pharo.org

Re: [Pharo-users] GitLab and Pharo

by Offray Vladimir Luna CÃ¡rdenas

Hi, On 20/10/16 12:17, Dimitris Chloupis wrote: > > Its not about monopoly, its just common logic, if you want the most > visibility github remains by far the most popular choice even when > compared against other VCSs. > [...] Popularity has a circular logic: choose something popular/visible because is popular/visible, but for some is more about autonomy, instead of visibility. Pharo and Fossil bring that to me and I think that the Iceberg way is abstracting git and trying to think critically about its workflow, which is also healthy and would add more diversity in the future. > > Its easy to get lost in the ocean of options but then I will never > complain about having too many options ;) I love too many options. > > I was always very vocal about git and github but never had a problem > people using alternatives. In the end what matters is the code itself > and whatever tool we can use to improve code, is more than welcomed > from me. > Agreed. I'm also pretty vocal about diversity, but that includes popular/visible options, while not reducing everything to it. So yes, having options is better for healthier communities and the code/artifacts they produce. Cheers, Offray

Oct. 20, 2016

Re: [Pharo-users] [Moose-dev] new themoosebook.org - work in progress

by Alexandre Bergel

Impressive!!!! Alexandre > On Oct 20, 2016, at 3:46 AM, Tudor Girba <tudor(a)tudorgirba.com> wrote: > > Hi, > > I am working on a new The Moose Book. You can see the current draft here: > http://themoosebook.org > > In the current form, it covers about 40% of what I want to have at the end. My target is to get a first complete version ready until Spring 2017. The book targets Moose 6.1, although most parts will work with Moose 6.0. > > The book is written in Pillar. A secondary goal for this book is to build a book editor with tools in Pharo. The current book was generated directly from Pharo without using the command line. The current code is in book GitHub repository, but the end goal is to have these tools working separately from the book. > > Please let me know what you think. > > The book repo is here: > https://github.com/girba/themoosebook > > Cheers, > Doru > > > -- > www.tudorgirba.com > www.feenk.com > > "Every thing has its own flow." > > > > > > _______________________________________________ > Moose-dev mailing list > Moose-dev(a)list.inf.unibe.ch > https://www.list.inf.unibe.ch/listinfo/moose-dev

Oct. 20, 2016

Re: [Pharo-users] [Seaside] Seaside can not be used with Pharo 60261

by Johan Brichau

I feel you pain. It is vastly underestimated how much work is required to keep up with upgrades that break backwards compatibility, from OS upgrades to Pharo upgrades and everything in betweenâ¦ Then again, the omelet does not make itself and certainly not without breaking the eggs ;) Johan > On 18 Oct 2016, at 17:29, Norbert Hartl <norbert(a)hartl.name> wrote: > > Thanks, that worked. Feels really strange encountering this. So one cannot use the commandline handler for loading a configuration anymore. Sad! The same way sad as you cannot use versionner anymore when you start to use BaselineOf instead of ConfigurationOf. > This is not a complaint because I can understand why this happens. It is just that we need more energy to solve all this than we have. Sad! > > Norbert > >> Am 18.10.2016 um 17:20 schrieb Johan Brichau <johan(a)inceptive.be <mailto:johan@inceptive.be>>: >> >> >>> On 18 Oct 2016, at 16:36, Norbert Hartl <norbert(a)hartl.name <mailto:norbert@hartl.name>> wrote: >>> >>> (ConfigurationOfAster project version: #development) load >> >> There are issues with this âoldâ way of Metacello loading. Can you try: >> >> Metacello new >> configuration:âAsterâ; >> version: #development; >> load. >> >> (Maybe you need to add the repo to, donât know). >> >> Cheers >> Johan >

Oct. 20, 2016

Re: [Pharo-users] [Seaside] Seaside can not be used with Pharo 60261

by Johan Brichau

Done! Looked good to me, but I did not test. If anyone experiences errors, let me know! Johan > On 20 Oct 2016, at 11:39, Norbert Hartl <norbert(a)hartl.name> wrote: > > Hi Johan, > > can you please upload the ConfigurationOfSeaside3 I've sent in this thread? > > thanks, > > Norbert > >> Am 18.10.2016 um 17:20 schrieb Johan Brichau <johan(a)inceptive.be <mailto:johan@inceptive.be>>: >> >> >>> On 18 Oct 2016, at 16:36, Norbert Hartl <norbert(a)hartl.name <mailto:norbert@hartl.name>> wrote: >>> >>> (ConfigurationOfAster project version: #development) load >> >> There are issues with this âoldâ way of Metacello loading. Can you try: >> >> Metacello new >> configuration:âAsterâ; >> version: #development; >> load. >> >> (Maybe you need to add the repo to, donât know). >> >> Cheers >> Johan >

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Dimitris Chloupis

well its not much of a problem really, pretty much any git repo website offers ways to mirror repos and keep them in sync. Gitlab also has facilities to import github repos and stay in sync with them. So you can maintain one repo on github and have it automatically update on gitlab and vice versa. Its not about monopoly, its just common logic, if you want the most visibility github remains by far the most popular choice even when compared against other VCSs. >From my perspective there is no need for support, I wont be abandoning for example gitup for iceberg anytime soon. I am perfectly ok with working with technologies outside the pharo image and in many cases I prefer it. The reason why I don't tie myself too much into the pharo image is that I can easily move between different technologies like Github and Gitlab. So i dont need Pharo to provide me support for Gitlab , I am already using it . Plus is just git. Its easy to get lost in the ocean of options but then I will never complain about having too many options ;) I love too many options. I was always very vocal about git and github but never had a problem people using alternatives. In the end what matters is the code itself and whatever tool we can use to improve code, is more than welcomed from me. On Thu, Oct 20, 2016 at 7:37 PM Offray Vladimir Luna CÃ¡rdenas < offray.luna(a)mutabit.com> wrote: > Hi, > > My only underline was about being diverse in infrastructure also. Your > personal motivations for choosing GitHub are as good as anyone's for not > doing so (including the critical approach Nadja is talking about, which I > recommend, again, as a good reading). > > I don't want to start a holy war anytime somebody mentions a DVCS that is > not Git/GitHub, a format that is not pillar, a license that is not MIT (and > hopefully each time we can focus on arguments instead of people). Last > discussion on licensing made clear for me why MIT (I had chosen it, but in > non image environments my license choice was different, and I did want to > understand the reasons behind). > > So we can have a small community, with the constrains of it, and still > encouraging a diverse ecosystem, choices and backgrounds. I can understand > that community can't support everything, but having a broader view of > alternatives and reasons behind is healthy in my opinion. > > Cheers, > > Offray > > On 20/10/16 11:21, Dimitris Chloupis wrote: > > No , no and no > > My fault if I did not make this clear so let me make this crystal > > *Under no circumstance choose GitLab over Github unless the following > conditions apply* > > *1) You want unlimited amount of free private repos* > *2) You want a 10GB repo* > *3) You want a 1GB webpage* > *4) You want to deploy at your own server a github like repo hub* > > Open source projects use public repos and for those Github is the best > choice. I was one of the first here to recommend pharo developers to move > to git and github , that wont change any time soon. > > In case you are not aware of a private repo is a repo that you wont be > able to clone, fork even view online. The only way to do the things you can > with a public repo is to be given specific permition and Gitlab offers a > huge array of permissions that are about cloning, forking, viewing, > creating new issues, merges , pull requests etc. > > Open source projects would make little to no sense to use a private repo, > hence Github remains the best choice mainly because of visibility and > exposure. > > > > On Thu, Oct 20, 2016 at 5:31 PM Offray Vladimir Luna CÃ¡rdenas < > offray.luna(a)mutabit.com> wrote: > > Hi, > > Anything that encourages diversity should be encouraged too. Of course > there is a balance to be found between diversity and fragmentation and > we're a small community, but even trying different Git front ends without > going to the same (monopolistic?) provider is healthy. > > For a critical perspective on GitHub and how it affects "open source" I > recommend: > > > https://medium.com/@nayafia/we-re-in-a-brave-new-post-open-source-world-56e… > > (there are a lot of good comments via hypothes.is ) > > Cheers, > > Offray > > On 20/10/16 08:39, Dimitris Chloupis wrote: > > One big factor for me has been also repo size , because I make games and > as you can imagine I need a lot of space. > > Bit bucket has a limit of 2GB per repo while GitLab has a limit of 10GB, > so for me GitLab is far better choice. > On Thu, 20 Oct 2016 at 16:31, Esteban Lorenzano <estebanlm(a)gmail.com> > wrote: > > bitbucket offers infinite private repos too, if you do not want to install > a server by your own. > > Esteban > > > On 20 Oct 2016, at 14:47, Dimitris Chloupis <kilon.alios(a)gmail.com> wrote: > > I have been looking for an alternative to Github to host my private repos, > Github provides only 1 private repo and for more you have to pay. So I > found this. > > https://gitlab.com/ > > Gitlab has all the features of Github with additional advantages that is > completely free and you can have as many private repos as you want. Also in > terms of space , its unlimited with a limit of 10 GB per repo which makes > it an excellent choice for binary files. You can have unlimited repos (the > hard limit is at 100.000 repos per user which you wont reach any time soon > ) > > A recent advantage that I discovered is that like Github , Gitlab allows > you to host your own website via Gitlab pages > > https://pages.gitlab.io/ > > The cool thing about this is that it comes with CI , which is highly > configurable which means you can even make it work with Pillar. The website > part can mix with existing code, meaning you can keep on the same repo the > code of your pharo projects and documentation in form of website. Gitlab > pages support a wide variety of static website generators , the on the > interests me is gitbook > > https://www.gitbook.com/ > > Gitbook is interesting because it comes with its own Editor you can > download as a native client that handles the writing of the book / > documentation and pushing and committing to the repo > > https://www.gitbook.com/editor > > Both Gitlab and Gitbook are free software that means they can be installed > in any Pharo server and customised to whatever you want > > I made an example here. > https://gitlab.com/Kilon/testbook > > The gitbook documentation is hosted in the pages branch which is a nice > clean way to isolate documentation from project's code but also you could > alternative have everything in master and put documentation in a doc > folder. You can fine tune such setup with the corresponding yaml setup file > as can see here > > https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml > > The website generated by this repo can be viewed here > > https://kilon.gitlab.io/testbook/ > > obviously you can also add anything that is in HTML/JS which make this > ideal for blog, main websites, application frontends and pretty much > everything you can imagine and because GitLab allows for unlimited amount > of repos you can have unlimited amount of websites. > > Have fun :) > > > > >

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Offray Vladimir Luna CÃ¡rdenas

Hi, My only underline was about being diverse in infrastructure also. Your personal motivations for choosing GitHub are as good as anyone's for not doing so (including the critical approach Nadja is talking about, which I recommend, again, as a good reading). I don't want to start a holy war anytime somebody mentions a DVCS that is not Git/GitHub, a format that is not pillar, a license that is not MIT (and hopefully each time we can focus on arguments instead of people). Last discussion on licensing made clear for me why MIT (I had chosen it, but in non image environments my license choice was different, and I did want to understand the reasons behind). So we can have a small community, with the constrains of it, and still encouraging a diverse ecosystem, choices and backgrounds. I can understand that community can't support everything, but having a broader view of alternatives and reasons behind is healthy in my opinion. Cheers, Offray On 20/10/16 11:21, Dimitris Chloupis wrote: > No , no and no > > My fault if I did not make this clear so let me make this crystal > * > * > *Under no circumstance choose GitLab over Github unless the following > conditions apply* > * > * > *1) You want unlimited amount of free private repos* > *2) You want a 10GB repo* > *3) You want a 1GB webpage* > *4) You want to deploy at your own server a github like repo hub* > * > * > Open source projects use public repos and for those Github is the best > choice. I was one of the first here to recommend pharo developers to > move to git and github , that wont change any time soon. > > In case you are not aware of a private repo is a repo that you wont be > able to clone, fork even view online. The only way to do the things > you can with a public repo is to be given specific permition and > Gitlab offers a huge array of permissions that are about cloning, > forking, viewing, creating new issues, merges , pull requests etc. > > Open source projects would make little to no sense to use a private > repo, hence Github remains the best choice mainly because of > visibility and exposure. > > > > On Thu, Oct 20, 2016 at 5:31 PM Offray Vladimir Luna CÃ¡rdenas > <offray.luna(a)mutabit.com <mailto:offray.luna@mutabit.com>> wrote: > > Hi, > > Anything that encourages diversity should be encouraged too. Of > course there is a balance to be found between diversity and > fragmentation and we're a small community, but even trying > different Git front ends without going to the same (monopolistic?) > provider is healthy. > > For a critical perspective on GitHub and how it affects "open > source" I recommend: > > https://medium.com/@nayafia/we-re-in-a-brave-new-post-open-source-world-56e… > > (there are a lot of good comments via hypothes.is > <http://hypothes.is> ) > > Cheers, > > Offray > > > On 20/10/16 08:39, Dimitris Chloupis wrote: >> One big factor for me has been also repo size , because I make >> games and as you can imagine I need a lot of space. >> >> Bit bucket has a limit of 2GB per repo while GitLab has a limit >> of 10GB, so for me GitLab is far better choice. >> On Thu, 20 Oct 2016 at 16:31, Esteban Lorenzano >> <estebanlm(a)gmail.com <mailto:estebanlm@gmail.com>> wrote: >> >> bitbucket offers infinite private repos too, if you do not >> want to install a server by your own. >> >> Esteban >> >> >>> On 20 Oct 2016, at 14:47, Dimitris Chloupis >>> <kilon.alios(a)gmail.com <mailto:kilon.alios@gmail.com>> wrote: >>> >>> I have been looking for an alternative to Github to host my >>> private repos, Github provides only 1 private repo and for >>> more you have to pay. So I found this. >>> >>> https://gitlab.com/ >>> >>> Gitlab has all the features of Github with additional >>> advantages that is completely free and you can have as many >>> private repos as you want. Also in terms of space , its >>> unlimited with a limit of 10 GB per repo which makes it an >>> excellent choice for binary files. You can have unlimited >>> repos (the hard limit is at 100.000 repos per user which you >>> wont reach any time soon ) >>> >>> A recent advantage that I discovered is that like Github , >>> Gitlab allows you to host your own website via Gitlab pages >>> >>> https://pages.gitlab.io/ >>> >>> The cool thing about this is that it comes with CI , which >>> is highly configurable which means you can even make it work >>> with Pillar. The website part can mix with existing code, >>> meaning you can keep on the same repo the code of your pharo >>> projects and documentation in form of website. Gitlab pages >>> support a wide variety of static website generators , the on >>> the interests me is gitbook >>> >>> https://www.gitbook.com/ >>> >>> Gitbook is interesting because it comes with its own Editor >>> you can download as a native client that handles the writing >>> of the book / documentation and pushing and committing to >>> the repo >>> >>> https://www.gitbook.com/editor >>> >>> Both Gitlab and Gitbook are free software that means they >>> can be installed in any Pharo server and customised to >>> whatever you want >>> >>> I made an example here. >>> https://gitlab.com/Kilon/testbook >>> >>> The gitbook documentation is hosted in the pages branch >>> which is a nice clean way to isolate documentation from >>> project's code but also you could alternative have >>> everything in master and put documentation in a doc folder. >>> You can fine tune such setup with the corresponding yaml >>> setup file as can see here >>> >>> https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml >>> >>> The website generated by this repo can be viewed here >>> >>> https://kilon.gitlab.io/testbook/ >>> >>> obviously you can also add anything that is in HTML/JS which >>> make this ideal for blog, main websites, application >>> frontends and pretty much everything you can imagine and >>> because GitLab allows for unlimited amount of repos you can >>> have unlimited amount of websites. >>> >>> Have fun :) >> >

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Dimitris Chloupis

No , no and no My fault if I did not make this clear so let me make this crystal *Under no circumstance choose GitLab over Github unless the following conditions apply* *1) You want unlimited amount of free private repos* *2) You want a 10GB repo* *3) You want a 1GB webpage* *4) You want to deploy at your own server a github like repo hub* Open source projects use public repos and for those Github is the best choice. I was one of the first here to recommend pharo developers to move to git and github , that wont change any time soon. In case you are not aware of a private repo is a repo that you wont be able to clone, fork even view online. The only way to do the things you can with a public repo is to be given specific permition and Gitlab offers a huge array of permissions that are about cloning, forking, viewing, creating new issues, merges , pull requests etc. Open source projects would make little to no sense to use a private repo, hence Github remains the best choice mainly because of visibility and exposure. On Thu, Oct 20, 2016 at 5:31 PM Offray Vladimir Luna CÃ¡rdenas < offray.luna(a)mutabit.com> wrote: > Hi, > > Anything that encourages diversity should be encouraged too. Of course > there is a balance to be found between diversity and fragmentation and > we're a small community, but even trying different Git front ends without > going to the same (monopolistic?) provider is healthy. > > For a critical perspective on GitHub and how it affects "open source" I > recommend: > > > https://medium.com/@nayafia/we-re-in-a-brave-new-post-open-source-world-56e… > > (there are a lot of good comments via hypothes.is ) > > Cheers, > > Offray > > On 20/10/16 08:39, Dimitris Chloupis wrote: > > One big factor for me has been also repo size , because I make games and > as you can imagine I need a lot of space. > > Bit bucket has a limit of 2GB per repo while GitLab has a limit of 10GB, > so for me GitLab is far better choice. > On Thu, 20 Oct 2016 at 16:31, Esteban Lorenzano <estebanlm(a)gmail.com> > wrote: > > bitbucket offers infinite private repos too, if you do not want to install > a server by your own. > > Esteban > > > On 20 Oct 2016, at 14:47, Dimitris Chloupis <kilon.alios(a)gmail.com> wrote: > > I have been looking for an alternative to Github to host my private repos, > Github provides only 1 private repo and for more you have to pay. So I > found this. > > https://gitlab.com/ > > Gitlab has all the features of Github with additional advantages that is > completely free and you can have as many private repos as you want. Also in > terms of space , its unlimited with a limit of 10 GB per repo which makes > it an excellent choice for binary files. You can have unlimited repos (the > hard limit is at 100.000 repos per user which you wont reach any time soon > ) > > A recent advantage that I discovered is that like Github , Gitlab allows > you to host your own website via Gitlab pages > > https://pages.gitlab.io/ > > The cool thing about this is that it comes with CI , which is highly > configurable which means you can even make it work with Pillar. The website > part can mix with existing code, meaning you can keep on the same repo the > code of your pharo projects and documentation in form of website. Gitlab > pages support a wide variety of static website generators , the on the > interests me is gitbook > > https://www.gitbook.com/ > > Gitbook is interesting because it comes with its own Editor you can > download as a native client that handles the writing of the book / > documentation and pushing and committing to the repo > > https://www.gitbook.com/editor > > Both Gitlab and Gitbook are free software that means they can be installed > in any Pharo server and customised to whatever you want > > I made an example here. > https://gitlab.com/Kilon/testbook > > The gitbook documentation is hosted in the pages branch which is a nice > clean way to isolate documentation from project's code but also you could > alternative have everything in master and put documentation in a doc > folder. You can fine tune such setup with the corresponding yaml setup file > as can see here > > https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml > > The website generated by this repo can be viewed here > > https://kilon.gitlab.io/testbook/ > > obviously you can also add anything that is in HTML/JS which make this > ideal for blog, main websites, application frontends and pretty much > everything you can imagine and because GitLab allows for unlimited amount > of repos you can have unlimited amount of websites. > > Have fun :) > > > >

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Esteban A. Maringolo

2016-10-20 10:30 GMT-03:00 Esteban Lorenzano <estebanlm(a)gmail.com>: > bitbucket offers infinite private repos too, if you do not want to install a > server by your own. Gitlab also offers a free SaaS, just like GitHub, or you can download Gitlab and use it on your own premises. Esteban A. Maringolo

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Offray Vladimir Luna CÃ¡rdenas

Hi, Anything that encourages diversity should be encouraged too. Of course there is a balance to be found between diversity and fragmentation and we're a small community, but even trying different Git front ends without going to the same (monopolistic?) provider is healthy. For a critical perspective on GitHub and how it affects "open source" I recommend: https://medium.com/@nayafia/we-re-in-a-brave-new-post-open-source-world-56e… (there are a lot of good comments via hypothes.is ) Cheers, Offray On 20/10/16 08:39, Dimitris Chloupis wrote: > One big factor for me has been also repo size , because I make games > and as you can imagine I need a lot of space. > > Bit bucket has a limit of 2GB per repo while GitLab has a limit of > 10GB, so for me GitLab is far better choice. > On Thu, 20 Oct 2016 at 16:31, Esteban Lorenzano <estebanlm(a)gmail.com > <mailto:estebanlm@gmail.com>> wrote: > > bitbucket offers infinite private repos too, if you do not want to > install a server by your own. > > Esteban > > >> On 20 Oct 2016, at 14:47, Dimitris Chloupis >> <kilon.alios(a)gmail.com <mailto:kilon.alios@gmail.com>> wrote: >> >> I have been looking for an alternative to Github to host my >> private repos, Github provides only 1 private repo and for more >> you have to pay. So I found this. >> >> https://gitlab.com/ >> >> Gitlab has all the features of Github with additional advantages >> that is completely free and you can have as many private repos as >> you want. Also in terms of space , its unlimited with a limit of >> 10 GB per repo which makes it an excellent choice for binary >> files. You can have unlimited repos (the hard limit is at 100.000 >> repos per user which you wont reach any time soon ) >> >> A recent advantage that I discovered is that like Github , Gitlab >> allows you to host your own website via Gitlab pages >> >> https://pages.gitlab.io/ >> >> The cool thing about this is that it comes with CI , which is >> highly configurable which means you can even make it work with >> Pillar. The website part can mix with existing code, meaning you >> can keep on the same repo the code of your pharo projects and >> documentation in form of website. Gitlab pages support a wide >> variety of static website generators , the on the interests me is >> gitbook >> >> https://www.gitbook.com/ >> >> Gitbook is interesting because it comes with its own Editor you >> can download as a native client that handles the writing of the >> book / documentation and pushing and committing to the repo >> >> https://www.gitbook.com/editor >> >> Both Gitlab and Gitbook are free software that means they can be >> installed in any Pharo server and customised to whatever you want >> >> I made an example here. >> https://gitlab.com/Kilon/testbook >> >> The gitbook documentation is hosted in the pages branch which is >> a nice clean way to isolate documentation from project's code but >> also you could alternative have everything in master and put >> documentation in a doc folder. You can fine tune such setup with >> the corresponding yaml setup file as can see here >> >> https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml >> >> The website generated by this repo can be viewed here >> >> https://kilon.gitlab.io/testbook/ >> >> obviously you can also add anything that is in HTML/JS which make >> this ideal for blog, main websites, application frontends and >> pretty much everything you can imagine and because GitLab allows >> for unlimited amount of repos you can have unlimited amount of >> websites. >> >> Have fun :) >

Oct. 20, 2016

Re: [Pharo-users] GitLab and Pharo

by Dimitris Chloupis

One big factor for me has been also repo size , because I make games and as you can imagine I need a lot of space. Bit bucket has a limit of 2GB per repo while GitLab has a limit of 10GB, so for me GitLab is far better choice. On Thu, 20 Oct 2016 at 16:31, Esteban Lorenzano <estebanlm(a)gmail.com> wrote: > bitbucket offers infinite private repos too, if you do not want to install > a server by your own. > > Esteban > > > On 20 Oct 2016, at 14:47, Dimitris Chloupis <kilon.alios(a)gmail.com> wrote: > > I have been looking for an alternative to Github to host my private repos, > Github provides only 1 private repo and for more you have to pay. So I > found this. > > https://gitlab.com/ > > Gitlab has all the features of Github with additional advantages that is > completely free and you can have as many private repos as you want. Also in > terms of space , its unlimited with a limit of 10 GB per repo which makes > it an excellent choice for binary files. You can have unlimited repos (the > hard limit is at 100.000 repos per user which you wont reach any time soon > ) > > A recent advantage that I discovered is that like Github , Gitlab allows > you to host your own website via Gitlab pages > > https://pages.gitlab.io/ > > The cool thing about this is that it comes with CI , which is highly > configurable which means you can even make it work with Pillar. The website > part can mix with existing code, meaning you can keep on the same repo the > code of your pharo projects and documentation in form of website. Gitlab > pages support a wide variety of static website generators , the on the > interests me is gitbook > > https://www.gitbook.com/ > > Gitbook is interesting because it comes with its own Editor you can > download as a native client that handles the writing of the book / > documentation and pushing and committing to the repo > > https://www.gitbook.com/editor > > Both Gitlab and Gitbook are free software that means they can be installed > in any Pharo server and customised to whatever you want > > I made an example here. > https://gitlab.com/Kilon/testbook > > The gitbook documentation is hosted in the pages branch which is a nice > clean way to isolate documentation from project's code but also you could > alternative have everything in master and put documentation in a doc > folder. You can fine tune such setup with the corresponding yaml setup file > as can see here > > https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml > > The website generated by this repo can be viewed here > > https://kilon.gitlab.io/testbook/ > > obviously you can also add anything that is in HTML/JS which make this > ideal for blog, main websites, application frontends and pretty much > everything you can imagine and because GitLab allows for unlimited amount > of repos you can have unlimited amount of websites. > > Have fun :) > > >

Oct. 20, 2016