Hi people!<div><br></div><div>I'm the "non-smalltalk dev" in this list ;-) And I want to say something.</div><div><br></div><div>Yes, I know there is the "Smalltalk way" of doing many things... but... in other technologies, no help system is practically used (since last decade? more?). The flow is:</div>
<div><br></div><div>- Google search</div><div>- Giving post resulst, or stack overflow question, answers</div><div><br></div><div>For samples, if the project is hosted in GitHub, usually there is a samples folder in the project. (well, I'm very proud of my samples in CobolScript</div>
<div><a href="https://github.com/ajlopez/CobolScript/tree/master/samples">https://github.com/ajlopez/CobolScript/tree/master/samples</a></div><div>;-)</div><div><br></div><div>The main use cases are usually described in .md pages at GitHub project site. You can add images too (see the raw version of <a href="https://github.com/ajlopez/CobolScript/tree/master/samples/templateweb">https://github.com/ajlopez/CobolScript/tree/master/samples/templateweb</a> to see how to link to a image hosted in the same GitHub project site). </div>
<div><br></div><div>You have the option of having a site, the branch gh-page, with an static site. And there are static sites generators, like Octopress. </div><div><br></div><div>I put simple online demo of my AjTalkJs (Smalltalk in JavaScript) in the gh-page branch of:</div>
<div><a href="https://github.com/ajlopez/AjTalkJs">https://github.com/ajlopez/AjTalkJs</a></div><div>it was published as</div><div><a href="http://ajlopez.github.com/AjTalkJs/">http://ajlopez.github.com/AjTalkJs/</a></div>
<div><br></div><div>As another branches, it can received pull request for improvements.</div><div><br></div><div>There is an administration option to create that branch with an initial style, and there are third--parties GitHub styles.</div>
<div><br></div><div>My 2 cents</div><div><br>Angel "Java" Lopez</div><div>@ajlopez</div><div>github:ajlopez</div><div><br><div class="gmail_quote">On Sat, Jan 5, 2013 at 9:20 AM, H. Hirzel <span dir="ltr"><<a href="mailto:hannes.hirzel@gmail.com" target="_blank">hannes.hirzel@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hello<br>
<br>
On 1/5/13, Germán Arduino <<a href="mailto:garduino@gmail.com">garduino@gmail.com</a>> wrote:<br>
> This is always a challenge, I mean collect all the knowledge disperse on<br>
> the mailing lists.<br>
<br>
Yes.<br>
<br>
> Don't think you that more than tons of workspaces we should port the Help<br>
> System? Someone looked into it to understand if is a big job?<br>
><br>
<br>
Yes, I think as well that mid term we need the help system from Squeak ported.<br>
It is included in Squeak and was done by Torsten Bergmann. It is on<br>
<a href="http://www.squeaksource.com" target="_blank">www.squeaksource.com</a> but as it is now part of the Squeak image I<br>
suggest to take that version.<br>
<br>
As for now having a few workspaces more (see the current help menu in<br>
the screen shot) is not an issue, I think.<br>
<br>
5 entries so far<br>
<br>
Maybe we can have a dividing bar after them so separate the five<br>
entries from 'VM statistics' and 'Space left'.<br>
<br>
Let's focus on more tests, useful expressions, code snippets to adapt and notes.<br>
(see the other mails of mine today)<br>
<br>
Another area to give some example code is "File operations".<br>
<br>
However it is probably not a big effort to port the HelpSystem (I did<br>
not check, maybe between 1....10 hours :-) ),<br>
<br>
It might be a good starting point for somebody who wants to get into<br>
porting packages to Cuis. So if anybody wants to take this one, that<br>
is very fine.<br>
<br>
Kind regards<br>
<br>
--Hannes<br>
<br>
_______________________________________________<br>
Cuis mailing list<br>
<a href="mailto:Cuis@jvuletich.org">Cuis@jvuletich.org</a><br>
<a href="http://jvuletich.org/mailman/listinfo/cuis_jvuletich.org" target="_blank">http://jvuletich.org/mailman/listinfo/cuis_jvuletich.org</a><br>
</blockquote></div><br></div>