Suggestion: Tutorial MD should be part of this project

solid-contrib / profile-viewer-tutorial

https://solid.inrupt.com/docs/app-on-your-lunch-break

48 stars 36 forks source link

Suggestion: Tutorial MD should be part of this project #3

Open colin-riddell opened 5 years ago

colin-riddell commented 5 years ago

Hi,

I think the tutorial here: https://solid.inrupt.com/docs/app-on-your-lunch-break - should have source put in this repo'. I'd like to be able to make PR's on it.

RubenVerborgh commented 5 years ago

We should probably link from this repo to that tutorial. Feel free to add to README.

nealmcb commented 5 years ago

Yes, I'd also like to be able to comment on the tutorial instructions themselves, which aren't here.

In particular, I was very puzzled when following the different steps. From the names like tutorials/lunch-break/steps/01 tt seemed clear that they were pointing to path names within the repo, which I couldn't find for the life of me. Finally I saw they were referring not to files but to tags.

That's a very clever way to make it easy to follow, but only when I realize how to easily use it. Clicking on a tag in a github site isn't easy to use, since it leads us to do copy-paste.

But telling us to clone the repo, and then, e.g.

git checkout tutorials/lunch-break/steps/08

and refresh the browser is an easy approach.

I've added that to the README.md which some people will notice. Referring to it from the tutorial itself would be better.

Thanks!

RubenVerborgh commented 5 years ago

It depends no how people want to follow it. My idea would be rather that they try to write the code themselves, right?

nealmcb commented 5 years ago

Often, probably so. I was curious to start by just observing the various pieces going together, and getting a sense from that what it was all about at first, rather than writing code in a language which is not my favorite. At any rate my main goal was to be clearer about the mechanics. Effective pedagogy for tutorials is something I'll leave for others. Thanks!

aaaagile commented 5 years ago

Wouldike to ftp to my solid pod to Control code.. How would I achieve that?

RubenVerborgh commented 5 years ago

Wouldike to ftp to my solid pod to Control code..

That is currently not supported.

aaaagile commented 5 years ago

OK, Thanks for the quick response 😊

aaaagile commented 5 years ago

So I would expect this to happen in the fullness of time? Big fan of tbl! Would like to revamp my website as I have spent my working life, before retirement, expounding his work at cern. djb.mypi.co Its my home site on a raspberry pi So you will see that I want to 'inrupt' it. 😊 Regards DJB

On Fri, 19 Oct 2018, 11:12 Ruben Verborgh, notifications@github.com wrote:

Wouldike to ftp to my solid pod to Control code..

That is currently not supported.

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/solid/profile-viewer-tutorial/issues/3#issuecomment-431314981, or mute the thread https://github.com/notifications/unsubscribe-auth/ApsgtvZVaCG0-j_tiqKtDBczqtiQsVBxks5umaVzgaJpZM4XE03u .