Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Online documentation / "walk-through" #5

Open
rubyFeedback opened this issue Aug 4, 2019 · 1 comment
Open

Online documentation / "walk-through" #5

rubyFeedback opened this issue Aug 4, 2019 · 1 comment

Comments

@rubyFeedback
Copy link

Not sure how much time you want to invest into this, but I recommend that in the event that you wish to have it available for a longer time, to also consider adding more online documentation for the application / tutorial that you wrote.

For example, I see code such as this erb here:

https://github.com/JHero23/ruby-sinatra-starter-app/tree/master/views

Css here:

https://github.com/JHero23/ruby-sinatra-starter-app/tree/master/public/css

And images here:

https://github.com/JHero23/ruby-sinatra-starter-app/tree/master/public/img

I think online documentation, perhaps either directly in the main README of
this project, or in some link, that would explain how to e. g. use this, would
help with the tutorial part of the project. For example: "what code do I have
to use in order for my sinatra application to show images, when the
images reside in this or that random directory".

Something like this would help IMO.

You don't have to do this in a day :) I think it is more than enough if you keep
that in the back of your mind over the next, say, 18 months or so (so my issue
should also be closed in due time; it's just meant as a recommendation).

Keep up the spirit - documentation in ruby is an area that could definitely be
improved, and the more knowledge people share here the better. Ruby as a
language is great but the documentation is ... hmm, not horrible but not
great; sort of somewhat average/mediocre in general. I learned sinatra some
time ago, I like it a lot, much more than rails; but now I have a hard time finding
more advanced stuff in sinatra. I had to google-collect snippets and stuff,
which is cumbersome, and I still can not solve some issues I'd love to solve
and others have already solved but not explained properly (e. g. authentication
support in a website ... I haven't found a simple solution for this yet).

@JHeroGR
Copy link
Owner

JHeroGR commented Aug 11, 2019

Thank you for the suggestion, I would assume that me writing some comments on my code and views would be sufficient enough to walk the new user through the repository. Thank you again. I will keep this open for the time being

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants