On 23 November 2012 15:33, dimitris chloupis <thekilon@yahoo.co.uk> wrote:
I dont know if that is going to sound like a crazy idea or a difficult idea but here it goes. I agree with you that included documentation is probably much better than pdfs or htlm. Excuse me if that was not your point , but that is certainly a belief of mine.
For my project Ephestos , I was thinking of creating a small morphic window that displays documentation 10 lines tops (no scrolling allowed) and has the ability to offer tutorials step by step. Very similar to ProfStef tutorial, I am a huge fan of learning like this coding.
This is why I said I am very interested in how the onboard help system works on Pharo. For me ideally If I can expand Pharo help system so that it can do ProfStef like tutorials for Athens in a step by step process I think that people will benefit a lot more than a pdf or hltm that is a long read. Of course this help system expansion wont benefit only Athens user but it could be used for documenting anything inside Pharo.
If I could integrate the help system with system browser that would be even better. I am open to any suggestions and criticism.
yeah.. it would be interesting to go that way.. self example: [ do something with athens here ] description: ' okay, here you can see we're drawing things blah blah ' You can look at AthensDemoMorph as a prototype for that. Use: AthensDemoMorph new openInWorld inspect and in inspector you can switch between figures using 'self nextFigure' or 'self prevFigure' turning it into nice window with illustration alongside of text describing it, is not too hard. -- Best regards, Igor Stasenko.