ondras / wwwsqldesigner

WWW SQL Designer, your online SQL diagramming tool
https://sql.toad.cz/?keyword=online_library
BSD 3-Clause "New" or "Revised" License
2.86k stars 722 forks source link

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

Open richardtomkins opened 7 years ago

richardtomkins commented 7 years ago

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?

ondras commented 7 years ago

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.

richardtomkins commented 7 years ago

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 commented 7 years ago

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.

ondras commented 7 years ago

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...

richardtomkins commented 7 years ago

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.

ondras commented 7 years ago

Here is a screen shot,

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

slinkous commented 7 years ago

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

ghost commented 7 years ago

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.

ondras commented 7 years ago

Added the link to README.md.

rickarubio commented 5 years ago

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