Skip to content

Conversation

@ramonsmits
Copy link
Member

Based on feedback by @adamralph

@mikeminutillo @tmasternak Might we just past the whole first section of the tutorial in the readme instead of linking to it?

Copy link
Contributor

@adamralph adamralph left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After these changes, I still don't know what running run.bat is going to do to my machine.

@ramonsmits
Copy link
Member Author

@adamralph That is why I'm asking @tmasternak and @mikeminutillo if we would want to copy the first section of the tutorial in the README as that contains what happens.

https://github.com/Particular/docs.particular.net/blob/monitoring-gettingstarted2/tutorials/monitoring/demo/index.md#running-the-sample

Would that help?

@adamralph
Copy link
Contributor

@ramonsmits I see. Yes, I think that would help. Currently it's not at all obvious that I should follow that link to find what running run.bat will do to my machine. The two things are in different parts of the document.

@tmasternak
Copy link
Member

tmasternak commented Nov 13, 2017

@adamralph can you have a look at current version? I've added single sentence per each option that explicitly states what the script will do.

@tmasternak tmasternak added this to the 0.3 milestone Nov 13, 2017
Copy link
Member

@tmasternak tmasternak left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've added by changes in commits

Copy link
Contributor

@adamralph adamralph left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tmasternak the added notes about what the script will do look good.

Does the script do enough to call out any other pre-requisities? E.g. if I have a clean Windows installation, does the README act as an entry point to all the required instructions to get the demo runnnig?


Self-contained demo showing all of the monitoring components working together. This accompanies the Particular Platform Monitoring Tutorial available at the following location:

- https://docs.particular.net/tutorials/monitoring/demo/
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This URL is a 404.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes this is 404 until we merge the tutorial:/ (which should be today or tomorrow)

@tmasternak
Copy link
Member

Does the script do enough to call out any other pre-requisities?

Yes if you have a fresh Windows installation pre-requisites are all you need to have the demo running.

@tmasternak tmasternak merged commit 36626b6 into localdb-without-docker Nov 13, 2017
@tmasternak tmasternak deleted the improved-readme branch November 13, 2017 13:50
@tmasternak
Copy link
Member

@adamralph I'm merging this PR. We can polish the Readme.md further in next releases.

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

Successfully merging this pull request may close these issues.

4 participants