wwwsqldesigner icon indicating copy to clipboard operation
wwwsqldesigner copied to clipboard

So, uh, how does one use this, eh?

Open richardtomkins opened this issue 9 years ago • 10 comments

I read the readme.md, ten times. I did not find a "HOW TO USE" or a "GETTING STARTED", or any other, "HERE'S WHAT YOU DO CAUSE IT'S NON-INTUITIVE INSTRUCTIONS" . How do you do it, make it work, use it, as it were?

richardtomkins avatar Jul 15 '16 00:07 richardtomkins

Hi,

there is no need to shout, I can hear you loud and clear.

It is not actually exactly clear what do you mean by using the application, as there are several possible usage scenarios.

If you want to just see the app, I would suggest clicking the very first external link on its GitHub page, the one that leads to the publicly hosted version.

Once you see the UI, you might be having some hard time navigating the app and/or understanding its concepts (those are tighly related to how RDBMSs work). This is where the GitHub Wiki comes into play: the Manual page provides some insights about the features available and the user interface.

You might also want to install and host the app yourself for various reasons. This is the typical GitHub drill: install git, clone the repo, use the app. Generally speaking, these steps are described in the Installation wikipage.

Finally, for advanced users, a guide to Extending the app is available.

ondras avatar Jul 15 '16 11:07 ondras

Hello,

The first external link on this page is a YouTube video. github repository https://github.com/ondras/wwwsqldesigner

Sorry, I was not shouting, I was expressing shear frustration.

All the best

On 15/07/2016 7:54 AM, Ondřej Žára wrote:

Hi,

there is no need to shout, I can hear you loud and clear.

It is not actually exactly clear what do you mean by /using/ the application, as there are several possible usage scenarios.

If you want to just see the app, I would suggest clicking the very first external link on its GitHub page, the one that leads to the publicly hosted version http://ondras.zarovi.cz/sql/demo/?keyword=default.

Once you see the UI, you might be having some hard time navigating the app and/or understanding its concepts (those are tighly related to how RDBMSs work). This is where the GitHub Wiki https://github.com/ondras/wwwsqldesigner/wiki comes into play: the Manual https://github.com/ondras/wwwsqldesigner/wiki/Manual page provides some insights about the features available and the user interface.

You might also want to install and host the app yourself for various reasons. This is the typical GitHub drill: install git, clone the repo, use the app. Generally speaking, these steps are described in the Installation https://github.com/ondras/wwwsqldesigner/wiki/Installation wikipage.

Finally, for advanced users, a guide to Extending https://github.com/ondras/wwwsqldesigner/wiki/Extending the app is available.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/ondras/wwwsqldesigner/issues/230#issuecomment-232933364, or mute the thread https://github.com/notifications/unsubscribe-auth/ASYKmn2HYWvbb9PwSLvPgyXh7UYLQZjCks5qV3UHgaJpZM4JM-Tq.

richardtomkins avatar Jul 15 '16 15:07 richardtomkins

Oh right, yeah, I see that now, ...

not on this page https://github.com/ondras/wwwsqldesigner/wiki

aw, there you are https://github.com/ondras/wwwsqldesigner

I must admit that I did not see the link, up there above all the other github file directory stuff.

I apologize, a great deal and I suppose you could also say I'm embarrassed.

A very nice looking product, although the default data display appears to have disappeared and now it's a grid with nothing on top. Cool though.

On 15/07/2016 7:54 AM, Ondřej Žára wrote:

Hi,

there is no need to shout, I can hear you loud and clear.

It is not actually exactly clear what do you mean by /using/ the application, as there are several possible usage scenarios.

If you want to just see the app, I would suggest clicking the very first external link on its GitHub page, the one that leads to the publicly hosted version http://ondras.zarovi.cz/sql/demo/?keyword=default.

Once you see the UI, you might be having some hard time navigating the app and/or understanding its concepts (those are tighly related to how RDBMSs work). This is where the GitHub Wiki https://github.com/ondras/wwwsqldesigner/wiki comes into play: the Manual https://github.com/ondras/wwwsqldesigner/wiki/Manual page provides some insights about the features available and the user interface.

You might also want to install and host the app yourself for various reasons. This is the typical GitHub drill: install git, clone the repo, use the app. Generally speaking, these steps are described in the Installation https://github.com/ondras/wwwsqldesigner/wiki/Installation wikipage.

Finally, for advanced users, a guide to Extending https://github.com/ondras/wwwsqldesigner/wiki/Extending the app is available.

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/ondras/wwwsqldesigner/issues/230#issuecomment-232933364, or mute the thread https://github.com/notifications/unsubscribe-auth/ASYKmn2HYWvbb9PwSLvPgyXh7UYLQZjCks5qV3UHgaJpZM4JM-Tq.

richardtomkins avatar Jul 15 '16 19:07 richardtomkins

I must admit that I did not see the link, up there above all the other github file directory stuff.

Okay, I will make this somewhat more visible :)

A very nice looking product, although the default data display appears to have disappeared and now it's a grid with nothing on top. Cool though.

Can you elaborate a bit on this? Perhaps by adding a screenshot? I am not sure I follow your description, but it looks like a bug...

ondras avatar Jul 16 '16 12:07 ondras

Here is a screen shot,

The first time I went to the link you had provided in your email there was a diagram, but not now.

On 16/07/2016 8:18 AM, Ondřej Žára wrote:

I must admit that I did not see the link, up there above all the
other github file directory stuff.

Okay, I will make this somewhat more visible :)

A very nice looking product, although the default data display
appears to have disappeared and now it's a grid with nothing on
top. Cool though.

Can you elaborate a bit on this? Perhaps by adding a screenshot? I am not sure I follow your description, but it looks like a bug...

— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/ondras/wwwsqldesigner/issues/230#issuecomment-233127797, or mute the thread https://github.com/notifications/unsubscribe-auth/ASYKmt0wE63tgpa_oleWgvewGzVi7R4Mks5qWMwpgaJpZM4JM-Tq.

richardtomkins avatar Jul 16 '16 14:07 richardtomkins

Here is a screen shot,

Hmm, where? I do not see any... perhaps the discussion does not allow image attachments?

ondras avatar Jul 19 '16 09:07 ondras

Could the documentation link lead first to this manual? Or another "manual" link? It took me some searching to find it

slinkous avatar Jan 16 '17 20:01 slinkous

So I got an email with slinkhous's comment and again had difficulty finding the link. Must be old age cause it 's just not obvious. Might I suggest the link be included in the README.md. And again I say, nice work indeed.

ghost avatar Jan 16 '17 21:01 ghost

Added the link to README.md.

ondras avatar Jan 17 '17 10:01 ondras

I think adding in a few words to help people get started with running this code locally would be helpful: https://github.com/ondras/wwwsqldesigner/pull/275

rickarubio avatar Dec 07 '18 00:12 rickarubio