<div dir="ltr"><div>It was only after 20 years of using Squeak that I was ever able to successfully build my first VM ever, just the other day, and only because the platform-specific instructions were good enough that even I was able to figure out the missing libraries myself.</div><div><div><br></div><div>Whatever is being discussed here about the HowToBuild's, I hope it is not about taking it back to some "generic" instructions that require expert C++ development knowledge to be able to figure out.  That's probably where the idea that "no one reads it" came from because, sure, if it targets a "members only" C++ experts audience that doesn't need documentation, it won't get read.  Likewise, when non-experts (e.g., me) spend valuable time trying, but failing, to build, it also won't get read again for a long time, because it's safer to just keep scraping up pre-built binaries wherever they can find them, rather than risk wasting more time failing to build.<div><div><br></div><div>Being able to build makes Squeak more valuable.  Whatever the solution, I hope this usability will not regress.</div></div></div></div><div><br></div><div> - Chris</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Feb 2, 2021 at 12:22 PM tim Rowledge <<a href="mailto:tim@rowledge.org" target="_blank">tim@rowledge.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
<br>
> On 2021-02-02, at 1:07 AM, Tobias Pape <<a href="mailto:Das.Linux@gmx.de" target="_blank">Das.Linux@gmx.de</a>> wrote:<br>
> <br>
> <br>
> While it is true what you say, no-one is going to expect this dispersion or even read these infos.<br>
> You can say that this is not proper, and you might be right, but people just won't do it.<br>
<br>
So the solution is to link them together in some manner, surely? We do really need the different details for the various types of vm & platforms.<br>
<br>
Would it be plausible to use Markdown format to link sections, or build a bundled doc?<br>
<br>
tim<br>
--<br>
tim Rowledge; <a href="mailto:tim@rowledge.org" target="_blank">tim@rowledge.org</a>; <a href="http://www.rowledge.org/tim" rel="noreferrer" target="_blank">http://www.rowledge.org/tim</a><br>
Useful random insult:- Understands English as well as any parrot.<br>
<br>
<br>
<br>
</blockquote></div>