Skip to content

Add hexagonal architecture presentation #519

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

Merged
merged 5 commits into from
Nov 27, 2016
Merged

Add hexagonal architecture presentation #519

merged 5 commits into from
Nov 27, 2016

Conversation

iluwatar
Copy link
Owner

As part of issue #197 I made a presentation about Hexagonal Architecture pattern with remark.js. If this is ok, I thought we could use similar method for all the pattern presentations.

@iluwatar
Copy link
Owner Author

@npathai @markusmo3 please review.

@markusmo3
Copy link
Contributor

Heya there,
had a quick look through and noticed some things.

  • Is the presentation intended to be a readme broken up into smaller pieces? Or more like a blogpost? (I'm already thinking about how we could generate those presentation automatically >.<)
  • Maybe it would be nice to also show the class diagram? Im not sure what the usage for such a presentation is, to just show the existence of such pattern or to explain it in detail?
  • The slides are kinda neutral, a little "clinical" (thats a german saying, im not sure it conveys the meaning) Does remark.js have themes?

I think of presentations as a more personal thing. Having one is nice to start from, but i wouldn't want to just present a direct copy to a crowd.

All in all, nice work. I didnt even know such a nice thing as remark.js existed before 👍

@iluwatar
Copy link
Owner Author

Thank you for the comments.

Is the presentation intended to be a readme broken up into smaller pieces? Or more like a blogpost? (I'm already thinking about how we could generate those presentation automatically >.<)

I thought about it while doing this, but I think the presentations need a bit different angle and can't be autogenerated from the content we already have. So yes, it has some bits from the README.md and then some new content.

Maybe it would be nice to also show the class diagram? Im not sure what the usage for such a presentation is, to just show the existence of such pattern or to explain it in detail?

Good point. I agree that for some patterns showing the class diagram makes sense but for this large architectural pattern I chose to leave it out.

The slides are kinda neutral, a little "clinical" (thats a german saying, im not sure it conveys the meaning) Does remark.js have themes?

Yes, I used the default styles and agree that it looks clinical. I'll look into this.

@iluwatar iluwatar merged commit 89e7f51 into master Nov 27, 2016
@iluwatar iluwatar deleted the presentation branch November 27, 2016 11:57
@Tschis
Copy link
Contributor

Tschis commented Nov 25, 2017

@iluwatar are you looking into this for other patterns? Since you did some manual work, as @markusmo3 suggested, it might get outdated if we don't have means of automatically updating it.

@iluwatar
Copy link
Owner Author

At the moment I'm not working on this but we are accepting pull request for presentations. We have selected remarkjs as the technology but otherwise it is manual work. I believe it can't be automated for good results. See https://github.com/iluwatar/java-design-patterns/wiki/01.-How-to-contribute for instuctions.

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.

3 participants