<div id="__MailbirdStyleContent" style="font-size: 10pt;font-family: Arial;color: #000000;text-align: left" dir="ltr"><div><span style="font-size: 10pt">Hi Eliot --</span><br></div><div><br></div><div>I uploaded a template to be completed. Something is tricky in the CI but the skeleton is there:</div><div><br></div><div><span style="font-size: 13.3333px">https://github.com/squeak-smalltalk/squeak.org/blob/master/_development/squeaksource_server.md</span><br></div><div><span style="font-size: 13.3333px">https://github.com/squeak-smalltalk/squeak.org/blob/master/_pages/squeaksource_server.md</span><br></div><div><span style="font-size: 13.3333px">https://github.com/squeak-smalltalk/squeak.org/blob/master/img/dev/squeaksource_server.png</span><br></div><div><span style="font-size: 13.3333px"><br></span></div><div><span style="font-size: 13.3333px">I am trying to figure out why the page does not build:</span></div><div><span style="font-size: 13.3333px"><br></span></div><div><span style="font-size: 13.3333px">https://github.com/squeak-smalltalk/squeak.org/runs/4537308664?check_suite_focus=true</span><br></div><div><span style="font-size: 13.3333px"><br></span></div><div><span style="font-size: 13.3333px">Best,</span></div><div><span style="font-size: 13.3333px">Marcel</span></div><div class="mb_sig"></div>
<blockquote class="history_container" type="cite" style="border-left-style: solid;border-width: 1px;margin-top: 20px;margin-left: 0px;padding-left: 10px;min-width: 500px">
<p style="color: #AAAAAA; margin-top: 10px;">Am 14.12.2021 17:21:21 schrieb Marcel Taeumel <marcel.taeumel@hpi.de>:</p><div style="font-family:Arial,Helvetica,sans-serif"><div id="__MailbirdStyleContent" style="font-size: 10pt;font-family: Arial;color: #000000;text-align: left" dir="ltr">
Hi Eliot --<div><br></div><div>You can find older instructions here: <a title="static project url" href="http://source.squeak.org/ss.html" style="font-size: 10pt">http://source.squeak.org/ss.html</a> (Wiki page)</div><div><br></div><div>Yes, I think we should add a new section on <a href="https://squeak.org/development/"><span style="font-size: 10pt">https://squeak.org/development/</span></a> under "Develop Your Own Applications" that explains how to set up SqueakSource/Monticello yourself.</div><div><br></div><div>Take the "Development process" as an example:</div><div><br></div><div><a href="https://github.com/squeak-smalltalk/squeak.org/blob/master/_development/development_process.md"><span style="font-size: 10pt">https://github.com/squeak-smalltalk/squeak.org/blob/master/_development/development_process.md</span></a><br></div><div>is the source for <a href="https://squeak.org/development/#development-process-1" style="font-size: 10pt"><span style="font-size: 10pt">https://squeak.org/development/#development-process-1</span></a></div><div><br></div><div><a href="https://github.com/squeak-smalltalk/squeak.org/blob/master/_pages/development_process.md"><span style="font-size: 10pt">https://github.com/squeak-smalltalk/squeak.org/blob/master/_pages/development_process.md</span></a><br></div><div>is the source for <a href="https://squeak.org/development_process/" style="font-size: 10pt"><span style="font-size: 10pt">https://squeak.org/development_process/</span></a></div><div><br></div><div>So, I think we could add in a similar fashion:</div><div>- _development/squeaksource_server.md</div><div>- _pages/squeaksource_server.md</div><div><br></div><div>And put updated information there. Maybe starting with the Wiki page above. A pull request would allow us to review the changes first. After merging, the CI (GitHub Actions) will update the new pages automatically.</div><div><br></div><div>***</div><div><br></div><div><span style="font-size: 10pt">Extending Monticello/MCZ to have an equivalent to readme.md is challenging. It's way easier to just add a ConfigurationOfCryptography to squeaksource.com/MetacelloRepository and document everything there. :-) </span><br></div><div><span style="font-size: 10pt"><br></span></div><div><span style="font-size: 10pt">Well, you could also add an empty "MyProjectReadme" package to your repository and use the commit message as an explanation of how to load the project. :-D No need to change the MCZ format.</span></div><div><br></div><div>Best,</div><div>Marcel</div><div class="mb_sig"></div>
<blockquote class="history_container" type="cite" style="border-left-style: solid;border-width: 1px;margin-top: 20px;margin-left: 0px;padding-left: 10px;min-width: 500px">
<p style="color: #AAAAAA; margin-top: 10px;">Am 14.12.2021 15:44:06 schrieb Eliot Miranda <eliot.miranda@gmail.com>:</p><div style="font-family:Arial,Helvetica,sans-serif">Hi all,<br><br> I want to add and satisfy two requirements for Monticello repositories.<br><br>The first is that<br>- there is a page on squeak.org that describes how to set up a Monticello repository and either points to the code necessary to build a Monticello repository image, or points to downloadable Monticello repository image & changes files. There is at least two paragraphs on Monticello in the Welcome workspace/Help tool that cover its general power (distributed VCS that can work fully disconnected) and how easy it is to set up.<br><br>The second is that repositories and repository inspectors are extended to include the equivalent of a README.md, a top-level readme for the entire repository, in which repository maintainers can give high-level, lay-of-the-land information. The README would appear at the top of the list of packages in a repository inspector.<br><br><br>The first requirement is for developers who wish to set up private and/or personal Monticello repositories. This is easy to do, but only if one knows how. Currently that information is missing from squeak.org and the Welcome workspace/Help tool.<br><br>The second requirement is to make loading code from repositories easier. I just had to ask Levente how to load a full configuration from the Cryptography repository because there is no where in the repository, visible from within the image, specifically visible from a repository inspector, to get this info.<br><br>Can we make this so?<br><br>_,,,^..^,,,_ (phone)<br><br></div></blockquote></div></div></blockquote></div>